{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "proteus-evolve-proteus--evolve-coding-agent-in-docker",
 "repo": "proteus-evolve/Proteus",
 "repo_url": "https://github.com/proteus-evolve/Proteus",
 "repo_slug": "proteus-evolve-proteus",
 "title": "Evolve a pi coding agent inside a Docker sandbox",
 "page_title": "How to evolve a pi coding agent inside a Docker sandbox with Proteus",
 "summary": "Run the pi harness with a DeepSeek key so it rewrites its own source inside an isolated container.",
 "who": "A developer who wants a real coding harness to evolve its own instructions, tools and source under container isolation.",
 "problem": "Letting a self-editing agent run its own code on a host machine is risky, and an application-level file sandbox does not contain it.",
 "outcome": "A run folder with the snapshotted pi harness across episodes, native session logs, and a visual replay of the changes.",
 "steps": [
  "Install Docker and get a DeepSeek API key, then set it in your shell environment (inferred)",
  "`pip install proteus-evolve==0.4.0`",
  "Build the prepared pi-src image by following environments/README.md in the repo (inferred)",
  "`proteus run --harness pi --arm neutral --seeds 1 --episodes 4 --out runs/<target>` (inferred flags) (inferred, check the README)",
  "`proteus visualize --out runs/<target>` (inferred, check the README)"
 ],
 "agent_prompt": "In the Proteus repo (proteus-evolve/Proteus), prepare the pi-src environment, then run the pi harness with the neutral arm for 4 episodes into runs/<target>. Expected output: episode records and a snapshot per episode, with the pi source extracted into harness/src/. Verify that each episode snapshot contains a passing candidate or a restored repair candidate.",
 "agents": [
  "any"
 ],
 "difficulty": "Advanced",
 "time": "2 hours",
 "basis": "readme",
 "caveat": "The pi integration needs Docker and a DeepSeek key, and the exact build and run flags beyond the README examples must be checked in the environments and adapter docs.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "Python 3.10 or newer",
  "pip to install proteus-evolve==0.4.0 (no model SDK is required for the minimal harness)",
  "For real harnesses: Docker and a DeepSeek or Codex key, as listed in the harness table"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The DeepSeek key is passed into the container through environment passthrough, so keep run folders and logs free of the key before sharing them."
  }
 ],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/proteus-evolve-proteus/evolve-coding-agent-in-docker/",
 "md": "https://dedupedai.com/use-cases/proteus-evolve-proteus/evolve-coding-agent-in-docker/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/proteus-evolve-proteus--evolve-coding-agent-in-docker.json",
 "api_version": "v1"
}