Self-evolving AI agent framework CLI
Project description
██╗ ███████╗██╗ ██╗ ██████╗
╚═╝ ██╔════╝██║ ██║██╔═══██╗
██╗ █████╗ ██║ ██║██║ ██║
██║ ██╔══╝ ╚██╗ ██╔╝██║ ██║
██║ ███████╗ ╚████╔╝ ╚██████╔╝
╚═╝ ╚══════╝ ╚═══╝ ╚═════╝
iEvo CLI
Self-evolving AI agent framework. Install agents like packages — they learn from every mistake.
Install
Requires Python 3.13+.
# Recommended — run without install
uvx ievo --help
# Or install globally
uv tool install ievo
# Or with pip
pip install ievo
Quick start
# Launch the TUI dashboard (auto-initializes project on first run)
ievo
All 12 agents are bundled in the package — no network required for setup.
Development
git clone https://github.com/ievo-ai/cli.git
cd cli
uv sync
# Always use `uv run` — it runs your local code, not the globally installed version
uv run ievo --help
uv run ievo # launch TUI from local source
uv run pytest --cov # run tests
# Or install globally as editable (links to your local source)
uv tool install --editable .
Docker sandbox
Agents run in isolated Docker containers by default — each with its own set of allowed tools.
# Build the sandbox image (first time)
docker build -t ievoai/sandbox:latest sandbox/
# Agents use Docker automatically
ievo run spec-writer -m "Build auth module"
# Skip Docker, run locally
ievo run spec-writer --local -m "Quick test"
Auto-fallback: if Docker is not available, agents run locally via Claude CLI.
Commands
The primary interface is the TUI dashboard (ievo without args). CLI commands are available but deprecated:
| Command | Description |
|---|---|
ievo |
Launch TUI dashboard (recommended) |
ievo update --self |
Update iEvo CLI to latest version |
ievo config |
View/set configuration |
ievo init |
Create a new project (deprecated — TUI auto-inits) |
ievo add <agent> |
Install agent (deprecated — use HR agent) |
ievo remove <agent> |
Remove an agent (deprecated — use HR agent) |
ievo list |
Show installed agents (deprecated — use TUI) |
ievo run <agent> |
Start agent session (deprecated) |
Links
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ievo-26.6.30.901.tar.gz.
File metadata
- Download URL: ievo-26.6.30.901.tar.gz
- Upload date:
- Size: 443.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0151276deaffeb4be6cd58c868d1dd47f1c3a0882d16188d5c2bea7234667a4f
|
|
| MD5 |
7a25d1e339c6db2c1d227eceeebc070a
|
|
| BLAKE2b-256 |
d0bae169e5f54571c513b9289b4b5d28ead94b4df213e12d344ef0de49e82f23
|
File details
Details for the file ievo-26.6.30.901-py3-none-any.whl.
File metadata
- Download URL: ievo-26.6.30.901-py3-none-any.whl
- Upload date:
- Size: 165.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e0845241b35c76ef5f4bedfa3c8c73aaa1d2b31c8403a61e8b015f383ad9a6eb
|
|
| MD5 |
ae5575eda6347bc96e440ff11550e08a
|
|
| BLAKE2b-256 |
3ab2063f9859276068076440fa7d95034abff01f1e0ebfc6a2d3f04f2752848b
|
