Skip to content

evolving-machines-lab/evolve

Repository files navigation

Evolve SDK

Run, deploy and monitor CLI agents in secure Cloud sandboxes.


  • Run any CLI agent (Claude Code, Codex, Gemini CLI, Qwen Code) in secure cloud sandboxes
  • Persistent filesystem for infinite context
  • Full computer access: terminal, browser, MCP tools
  • Agent skills: extend agents with custom capabilities (PDF, dev-browser, etc.)
  • 500+ integrations (Gmail, GitHub, Slack, Notion & more) via Composio
  • Functional programming abstractions (map, filter, reduce) for massively parallel workloads
  • Streaming and structured output
  • Built-in agent observability and analytics dashboard
  • Much more coming...

Add the evolve-dev SKILL to your favorite coding agent and start building with Evolve SDK:

git clone https://github.com/evolving-machines-lab/evolve.git
cp -r evolve/skills/evolve-dev ~/.claude/skills/       # Claude Code
cp -r evolve/skills/evolve-dev ~/.codex/skills/        # Codex
cp -r evolve/skills/evolve-dev ~/.gemini/skills/       # Gemini CLI
cp -r evolve/skills/evolve-dev ~/.qwen-code/skills/    # Qwen Code

Get Started

1. Install the SDK

npm install @evolvingmachines/sdk    # TypeScript
pip install evolve-sdk    # Python

Note: Requires Node.js 18+ (the Python SDK uses a lightweight Node.js bridge).

2. Run your first agent

Bring your own keys:

# .env - Direct (BYOK)
ANTHROPIC_API_KEY=sk-ant-...         # or CLAUDE_CODE_OAUTH_TOKEN (Claude Max), OPENAI_API_KEY, GEMINI_API_KEY
E2B_API_KEY=e2b_...                  # sandbox provider, get at https://e2b.dev

Or get your Evolve API key at dashboard.evolvingmachines.ai (see 3. below):

# .env - Gateway
EVOLVE_API_KEY=sk-...

Then run:

import { Evolve } from "@evolvingmachines/sdk";

const evolve = new Evolve();  // auto-resolves env variables
await evolve.run({ prompt: "Create hello.txt with 'Hello World'" });
const output = await evolve.getOutputFiles();  // output.files
from evolve import Evolve

evolve = Evolve()  # auto-resolves env variables
await evolve.run(prompt="Create hello.txt with 'Hello World'")
output = await evolve.get_output_files()  # output.files

3. Unlock full power with Evolve API key

Sign up at dashboard.evolvingmachines.ai and get your Evolve API key for:

  • Agent execution traces, observability and analytics
  • Centralized billing across all providers
  • Mix any model with any CLI agent
  • $10 FREE CREDITS, no CC required

4. Learn more

Check out the documentation and cookbooks.

Documentation

Support + Talk with Founders

Reporting Bugs

We welcome your feedback. File a GitHub issue to report bugs or request features.

License

See the LICENSE file for full terms and conditions.

About

Run, deploy and monitor CLI agents in secure cloud sandboxes.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •