{"id":50172875,"url":"https://github.com/zigrivers/server-setup","last_synced_at":"2026-05-25T00:15:40.771Z","repository":{"id":359158602,"uuid":"1244806817","full_name":"zigrivers/server-setup","owner":"zigrivers","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-20T16:36:15.000Z","size":130,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-20T21:43:12.883Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zigrivers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-20T16:04:37.000Z","updated_at":"2026-05-20T16:36:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zigrivers/server-setup","commit_stats":null,"previous_names":["zigrivers/server-setup"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/zigrivers/server-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigrivers%2Fserver-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigrivers%2Fserver-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigrivers%2Fserver-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigrivers%2Fserver-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zigrivers","download_url":"https://codeload.github.com/zigrivers/server-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zigrivers%2Fserver-setup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33455147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-24T19:21:36.376Z","status":"ssl_error","status_checked_at":"2026-05-24T19:21:10.562Z","response_time":57,"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":[],"created_at":"2026-05-25T00:15:40.085Z","updated_at":"2026-05-25T00:15:40.760Z","avatar_url":"https://github.com/zigrivers.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Local AI Stack Repo\n\nThis repository is the source-controlled home for your two-Mac local AI development system.\n\nIt is designed to be edited and improved with **Claude Code** and **Codex**, while the actual local execution pipeline runs on your Apple Silicon machines:\n\n```text\nMachine 1 / daily driver / control plane\n  - Claude Code + Codex\n  - VS Code / Cursor\n  - LangGraph controller\n  - MCP bridge\n  - local Orchestrator model on 127.0.0.1:8001\n\nThunderbolt Bridge\n  - Machine 1: 10.10.10.1\n  - Machine 2: 10.10.10.2\n\nMachine 2 / inference worker\n  - Developer model on 10.10.10.2:8002\n  - Reviewer model on 10.10.10.2:8003\n  - optional experimental MTP / security reviewer on 10.10.10.2:8004\n```\n\n## What this repo contains\n\n```text\nsrc/local_ai_stack/\n  local_agents.py          LangGraph Orchestrator → Developer → Reviewer loop\n  local_exec_plan.py       Executes frontier-generated plan files in git worktrees\n\nmcp/local_delegate_mcp/\n  server.py                MCP bridge for Claude Code / Codex\n\nscripts/\n  launchers, installers, download helpers, status checks, benchmark helpers\n\n.agents/skills/\n  delegate-local/          Antigravity CLI skill for plan → local execution\n  local-review/            Antigravity CLI skill for local second-opinion review\n  local-ai-status/         Antigravity CLI skill for checking endpoints\n\nskills/claude/\n  delegate-local/          Claude Code skill for plan → local execution\n  local-review/            Claude Code skill for local second-opinion review\n  local-ai-status/         Claude Code skill for checking endpoints\n\nconfigs/\n  env examples, endpoint examples, launchd templates\n\ndocs/\n  architecture, setup, operations, troubleshooting, and workflow docs\n\nprompts/\n  reusable prompts for frontier planning and review\n\nplans/\n  starter example plan files\n\nbenchmarks/\n  local model benchmark prompts\n```\n\n## Quick start\n\nUnzip this repo and put it somewhere stable, preferably:\n\n```bash\nmkdir -p ~/ai\nmv local-ai-stack-repo ~/ai/local-ai-stack\ncd ~/ai/local-ai-stack\n```\n\nInitialize git:\n\n```bash\ngit init\ngit add .\ngit commit -m \"Initial local AI stack repo\"\n```\n\nCreate the repo virtual environment on **Machine 1**:\n\n```bash\nuv venv .venv --python 3.12\nsource .venv/bin/activate\nuv pip install -e '.[mcp]'\n```\n\nCopy the environment template:\n\n```bash\ncp configs/env.machine1.example .env\n```\n\nEdit `.env` and confirm the model paths match your actual machines.\n\nStart the Orchestrator on Machine 1:\n\n```bash\nscripts/start-orchestrator.sh\nscripts/m1-ai-status.sh\n```\n\nMake sure the Machine 2 worker models are already running, then smoke test:\n\n```bash\npython -m local_ai_stack.local_agents \\\n  --workspace ~/ai/workspaces/hello_agent \\\n  \"Create a tiny README.md file that says the split-machine local multi-agent system is working.\"\n```\n\n## Recommended iteration workflow\n\nUse this repo itself the same way you want to use future project repos:\n\n1. Ask Claude Code or Codex to create a plan in `plans/`.\n2. Review the plan yourself.\n3. Let the local stack execute the plan in a worktree.\n4. Ask Claude/Codex to do final architecture and docs review.\n5. Merge manually.\n\nThe principle is simple:\n\n```text\nFrontier models write the contract.\nLocal models execute the contract.\nYou approve the merge.\n```\n\n## Important safety defaults\n\n- Local agents should only work inside git repos or isolated worktrees.\n- Do not expose MLX servers to the public internet.\n- Do not use `model=local` with `mlx_lm.server`; use the full model path.\n- Do not let agents run destructive shell commands outside a disposable workspace.\n- Do not auto-commit security, auth, payment, migration, or deployment changes.\n\nSee `docs/SETUP.md` and `docs/OPERATIONS.md` for the full setup and daily workflow.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzigrivers%2Fserver-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzigrivers%2Fserver-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzigrivers%2Fserver-setup/lists"}