Sorcerer is a local-first autonomous coding agent that plans, edits, verifies, recovers from failures, and keeps moving until acceptance criteria are satisfied.
If this project helps you, please star it and join discussions:
- Star: github.com/MohaMehrzad/Sorcerer/stargazers
- Discuss: github.com/MohaMehrzad/Sorcerer/discussions
- Actually autonomous: multi-agent planning, coding, critique, and synthesis loops.
- Recovery built in: checkpoint/resume + supervisor retries + adaptive budgets.
- Safer by default: write-path safeguards, command allowlists, verification gates.
- Made for real repos: local workspace operation, memory, continuation packets, observability.
git clone https://github.com/MohaMehrzad/Sorcerer.git
cd Sorcerer
pnpm install
cp .env.example .env.local
# set MODEL_API_KEY in .env.local
pnpm dev- Frontend: http://localhost:7777
- Backend: http://localhost:7778
- Multi-agent async orchestration (
supervisor,scout,planner,coder,critic,synthesizer) - Single-agent compatibility mode with resume + fallback
- Long-term memory with contradiction detection and evidence gating
- Completion contract checks before accepting "done"
- Adaptive file/command budgets under hard safety ceilings
- Preflight + verification execution with flaky retry/quarantine support
- Telemetry export and run artifacts for auditing
- Node.js 20+
pnpm- Python 3
- Python package
ddgsfor web search helper:pip install ddgs
Create .env.local from .env.example.
Key variables:
MODEL_API_KEY(required unless provided in onboarding)MODEL_API_URL(optional)MODEL_NAME(optional)WORKSPACE_DIR(optional, defaults to repo root)ENABLE_RUNTIME_EXECUTION(optional, defaults to disabled; set to1only if you explicitly want/api/execute)
Main controls in UI:
- Execution mode: multi-agent async or single-agent legacy
- Max iterations (
0= unbounded) - Parallel work units, critic threshold, team size
- Strict verification, auto-fix verification, preflight checks
- Clarification gate, rollback on failure, dry-run
- File-write and command-run budgets
- Local command execution + file mutations are guarded by safety policies.
- Sensitive paths under
.tmp, hidden internal folders, and secret-like files are blocked from file mutations. /api/executeis opt-in and disabled by default unlessENABLE_RUNTIME_EXECUTION=1is set.- API supports localhost/origin checks and optional auth token.
Read:
See CHANGELOG.md.
See docs/LAUNCH_PLAYBOOK.md for launch strategy and ready-to-post distribution copy.
See docs/COMMUNITY_GROWTH_CHECKLIST.md for weekly operating cadence.
See docs/GITHUB_PROJECT_SETUP.md for Projects v2 bootstrap.
- Agents: custom agent profiles in
.github/agents - Discussions: category forms in
.github/DISCUSSION_TEMPLATE - Actions: CI + security + community workflows in
.github/workflows - Wiki source:
docs/wiki(sync viascripts/sync-wiki.sh) - Security: policy in
SECURITY.mdand automated checks in Actions
See SUPPORT.md.
MIT - see LICENSE.