8000 GitHub - maghamalyan/evolv: Local-first evolutionary idea lab: a FastAPI + React app that generates and refines ideas using evolutionary operators and an LLM critic. · GitHub
[go: up one dir, main page]
Skip to content
{"props":{"color_mode":"dark","logged_in":false,"marketing_page":false,"home_path":"/","login_path":"/login?return_to=https%3A%2F%2FgitHub.com%2Fmaghamalyan%2Fevolv","signup_path":"/signup?ref_cta=Sign+up\u0026ref_loc=header+logged+out\u0026ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E\u0026source=header-repo\u0026source_repo=maghamalyan%2Fevolv","signup_enabled":true,"is_signup_controller":false,"show_search_and_nav":true,"hide_search":false,"private_mode_enabled":false,"should_use_dotcom_links":true,"auth_hydro_click":"{\"event_type\":\"authentication.click\",\"payload\":{\"location_in_page\":\"site header menu\",\"repository_id\":null,\"auth_type\":\"SIGN_UP\",\"originating_url\":\"https://gitHub.com/maghamalyan/evolv\",\"user_id\":null}}","auth_hydro_click_hmac":"097255291dd8bd6df56530d30b2388c1d76086fb49cce16d0543f70758963374"}}
maghamalyan
evolv
Public

About

Local-first evolutionary idea lab: a FastAPI + React app that generates and refines ideas using evolutionary operators and an LLM critic.

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository
BranchesTags

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
backend
backend
 
 
frontend
frontend
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 

Repository files navigation

Evolutionary Idea Lab

Local-first system for interactive idea generation and refinement with an evolutionary algorithm + LLM generator/critic agents.

Stack

  • Backend: Python + FastAPI + SQLite (uv workflow)
  • Frontend: React + TypeScript + Vite (bun workflow)
  • LLM provider: OpenRouter chat completions API

Project Layout

  • /Users/mishaaghamalyan/Development/personal/evolv/backend FastAPI backend
  • /Users/mishaaghamalyan/Development/personal/evolv/frontend React frontend
  • /Users/mishaaghamalyan/Development/personal/evolv/data SQLite DB, project artifacts, checkpoints, exports

Backend (uv)

  1. Install deps
cd /Users/mishaaghamalyan/Development/personal/evolv/backend
uv sync
  1. Optional OpenRouter config
export EVOLV_OPENROUTER_API_KEY="your_key"

If no key is set, backend runs in deterministic mock-LLM mode.

  1. Run server
uv run uvicorn app.main:app --reload --port 8000

Frontend (bun)

  1. Install deps
cd /Users/mishaaghamalyan/Development/personal/evolv/frontend
bun install
  1. Run dev server
bun run dev

Frontend proxies /api and /ws to backend on localhost:8000.

Implemented Core Features

  • Project CRUD with problem statement, criteria, hyperparams, seed ideas
  • Async run orchestration with start, pause, resume, stop
  • Evolution operators: mutate, crossover, random inject, elitism
  • Critic scoring with weighted aggregate objective
  • Diversity scoring (sentence-transformers with fallback)
  • WebSocket live event stream
  • Checkpoint creation and resume-from-checkpoint support
  • Run results endpoint + Markdown/JSON export
  • SQLite persistence + on-disk artifacts
  • Health + Prometheus metrics endpoints

API Surface

  • POST /api/projects
  • GET /api/projects
  • GET /api/projects/{project_id}
  • PATCH /api/projects/{project_id}
  • POST /api/projects/{project_id}/runs
  • GET /api/runs/{run_id}
  • POST /api/runs/{run_id}/pause
  • POST /api/runs/{run_id}/resume
  • POST /api/runs/{run_id}/stop
  • POST /api/runs/{run_id}/checkpoint
  • GET /api/runs/{run_id}/results
  • GET /api/runs/{run_id}/export?format=json|md
  • GET /api/runs/{run_id}/events
  • GET /health/live
  • GET /health/ready
  • GET /metrics
  • WS /ws/runs/{run_id}

Tests

cd /Users/mishaaghamalyan/Development/personal/evolv/backend
uv run pytest

Notes

  • This is V1 local-first architecture with in-process async workers.
  • Cost/token telemetry is informational only in this version.

About

Local-first evolutionary idea lab: a FastAPI + React app that generates and refines ideas using evolutionary operators and an LLM critic.

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages
0