Otto
A terminal AI agent that works on a codebase, a container, a browser or a
desktop, uses what it built, and judges its own work against criteria it
wrote before it started. One agent loop with modes over four model vendors,
a rubric-first evaluator, tiered memory, six benchmark harnesses, and 1,685
tests that need no API key. It embeds: agent.embed is the surface an app
with Otto's Python inside it depends on.
Install
pip install "otto-cli-agent[local-embeddings]"
otto doctor
otto tui
The local-embeddings extra is the on-device embedding model; without it
recall uses a Gemini key when there is one, and recency otherwise. [serve]
adds otto serve, the agent behind a WebSocket for the phone app.
Put keys in a .env in the directory you run it from. INCEPTION_API_KEY
is required (it alone serves the fill-in-the-middle and edit endpoints);
OPENAI_API_KEY, ANTHROPIC_API_KEY and GEMINI_API_KEY are optional and
each unlocks the seats routed to that vendor. otto tui opens its setup
screen on first start when nothing is configured. Python 3.12 or newer.
What it does
- One agent loop with four modes that swap the model underneath without losing the conversation; routing that learns from outcomes, per-model cooldowns and a per-provider circuit breaker.
- A rubric written from the task before any attempt, shared by the loop and the judge, so the judge never grades against the actor's own output.
- Once-only holds before an irreversible action, before finishing on unrun code, and before finishing without using what was built.
- 18 tools: shell and Python, files,
code_map, a browser,exercise(walk through a page, a served app, a CLI, an API, a terminal program or a device app and report each step as the machine saw it), a desktop, web search, workspace search and memory recall. - Tiered memory with type-aware compaction and two-stage semantic recall (96% on LoCoMo), a lesson bank, and sessions that survive the process.
- A Textual TUI with a setup screen, live progress, a token and dollar ledger; a REPL with the same pipeline.
- Six benchmark harnesses: a golden set, SWE-bench Verified, Claw-Eval, LoCoMo, a compaction bench and Humanity's Last Exam.
Links
- Source, folder-by-folder READMEs and screenshots: https://github.com/siddharth23P/otto_agent
- Website: https://siddharth23p.github.io/otto_agent/
- How it was built, commit by commit, with the measurement behind each change: https://github.com/siddharth23P/otto_agent/blob/main/docs/HISTORY.md
- The research each design decision draws on: https://github.com/siddharth23P/otto_agent/blob/main/docs/RESEARCH.md
MIT licensed.
1 maintainer
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 otto_cli_agent-0.1.2.tar.gz.
File metadata
- Download URL: otto_cli_agent-0.1.2.tar.gz
- Upload date:
- Size: 6.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
97350ffb7c4dbf7ab3fbb5a5e889830e9890e176fae8ffcf648809a34e91487e
|
|
| MD5 |
8629f63cdbd75dd21ccb9a2d42539d22
|
|
| BLAKE2b-256 |
9a264797daf714a13752d2b5f2ae0219b723cdf09096da97f7237f381262ae5a
|
Provenance
The following attestation bundles were made for otto_cli_agent-0.1.2.tar.gz:
Publisher:
publish.yml on siddharth23P/otto_agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
otto_cli_agent-0.1.2.tar.gz -
Subject digest:
97350ffb7c4dbf7ab3fbb5a5e889830e9890e176fae8ffcf648809a34e91487e - Sigstore transparency entry: 2860863800
- Sigstore integration time:
-
Permalink:
siddharth23P/otto_agent@1cd1693983f337f29ec68887a4b2e98669636fa9 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/siddharth23P
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1cd1693983f337f29ec68887a4b2e98669636fa9 -
Trigger Event:
release
-
Statement type:
File details
Details for the file otto_cli_agent-0.1.2-py3-none-any.whl.
File metadata
- Download URL: otto_cli_agent-0.1.2-py3-none-any.whl
- Upload date:
- Size: 647.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a1dc9ceb5d72eb374edb2feda03998ba47a7d26054b62cb73a669ad6e9a06ac8
|
|
| MD5 |
e0586de30671515eea067ff771ff311f
|
|
| BLAKE2b-256 |
1823bf8a84c932333b337462ac8920d29469d96ea9858cf70141cbfd6b9852fc
|
Provenance
The following attestation bundles were made for otto_cli_agent-0.1.2-py3-none-any.whl:
Publisher:
publish.yml on siddharth23P/otto_agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
otto_cli_agent-0.1.2-py3-none-any.whl -
Subject digest:
a1dc9ceb5d72eb374edb2feda03998ba47a7d26054b62cb73a669ad6e9a06ac8 - Sigstore transparency entry: 2860863843
- Sigstore integration time:
-
Permalink:
siddharth23P/otto_agent@1cd1693983f337f29ec68887a4b2e98669636fa9 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/siddharth23P
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1cd1693983f337f29ec68887a4b2e98669636fa9 -
Trigger Event:
release
-
Statement type:
