{"id":48589692,"url":"https://github.com/roycoding8/recursia","last_synced_at":"2026-04-14T06:05:20.586Z","repository":{"id":350052372,"uuid":"1205097905","full_name":"RoyCoding8/Recursia","owner":"RoyCoding8","description":"Algorithmic context manager and execution engine for multi-agent workflows. Reduces TTFT and isolates attention by routing the minimal topological R/W subset to parallel LLMs.","archived":false,"fork":false,"pushed_at":"2026-04-08T17:51:34.000Z","size":345,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-08T18:34:17.837Z","etag":null,"topics":["agentic-workflows","agents","context-management","llm","ttft-optimization"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RoyCoding8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-08T16:23:59.000Z","updated_at":"2026-04-08T17:51:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/RoyCoding8/Recursia","commit_stats":null,"previous_names":["roycoding8/recursia"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/RoyCoding8/Recursia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoyCoding8%2FRecursia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoyCoding8%2FRecursia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoyCoding8%2FRecursia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoyCoding8%2FRecursia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RoyCoding8","download_url":"https://codeload.github.com/RoyCoding8/Recursia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RoyCoding8%2FRecursia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31569400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-workflows","agents","context-management","llm","ttft-optimization"],"created_at":"2026-04-08T19:00:22.855Z","updated_at":"2026-04-08T19:00:25.637Z","avatar_url":"https://github.com/RoyCoding8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Recursia\n\nRecursia is a recursive orchestration system for turning a single objective into a structured execution tree, evaluating intermediate results, and surfacing the full run in a live graph UI.\n\nThe project is split into a FastAPI backend and a Next.js frontend. The backend handles run lifecycle, recursive execution, persona routing, checker evaluation, merge flow, and event streaming. The frontend provides Mission Control for starting runs, inspecting node state, reviewing proposed files, and applying approved changes into a user-selected folder.\n\n## Highlights\n\n- Recursive divide-route-execute workflow\n- Persona-based execution with markdown-backed persona profiles\n- Live run graph and event console\n- Proposal-based file generation instead of opaque server-side writes\n- Review-and-apply workflow for writing approved files into a selected folder\n- Separate validation feedback for checker verdicts versus real runtime failures\n\n## Repository Layout\n\n- `backend/` FastAPI API, orchestration runtime, state management, and tests\n- `frontend/` Next.js Mission Control UI and component/E2E tests\n- `personas/` markdown persona profiles discovered at runtime\n- `theory/` product and architecture notes\n- `run.bat` Windows launcher for local setup and development\n\n## Quick Start\n\n### Launchers\n\nWindows:\n\n```powershell\n.\\run.bat\n```\n\nLinux and macOS:\n\n```bash\nbash ./run.sh\n```\n\nBoth launchers can install dependencies, start the backend and frontend, and open the app in your browser when the environment supports it.\n\n### Manual startup\n\nBackend:\n\n```powershell\ncd backend\nuv sync\nuv run uvicorn main:app --reload\n```\n\nFrontend:\n\n```powershell\ncd frontend\nnpm ci\nnpm run dev\n```\n\nThe frontend expects the backend at `http://127.0.0.1:8000` by default.\n\n## Tooling\n\nThe backend is managed as a `uv` project and should be installed with `uv sync`. The frontend uses `npm` with the checked-in `package-lock.json` for deterministic installs.\n\n## Personas\n\nPersona profiles are loaded from `personas/*.md`. The frontend exposes these profiles as selectable base personas when starting a run. The selected base persona is applied to the root node, while downstream nodes may still route to other personas as needed.\n\n## Development Notes\n\n- Backend tests live under `backend/tests/`\n- Frontend tests live under `frontend/tests/`\n- Local generated artifacts are intentionally excluded from version control via `.gitignore`\n\n## Continuous Integration\n\nGitHub Actions runs basic checks on push and pull request across Windows, macOS, and Linux:\n\n- backend `uv run pytest -q`\n- frontend `npm run typecheck`\n- frontend `npm run test:components`\n\n## License\n\nThis project is released under the Apache License 2.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froycoding8%2Frecursia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froycoding8%2Frecursia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froycoding8%2Frecursia/lists"}