Skip to main content

monkeybot

monkeybot Logo

Multi-cloud agent harness — GCP-first docs, portable runtime

License: MIT

monkeybot is an owned agent runtime for tool-using LLMs: a FastAPI SSE gateway, pluggable storage, MCP tools, skills, and memory. Run locally with zero cloud dependencies, or ship the same container image anywhere Docker runs.

Docs and examples are GCP-first (Vertex, GCS, Cloud Run); AWS paths ship in the Pattern guides. See Cloud deployment — Positioning.

Quick start

Install uv, then:

# browser-harness pins Pillow 12. Core 3.12 needs Pillow 13, and
# `uv tool install` ignores the package override unless this file is passed.
# Without it the resolver stays on core 3.10.0.
printf 'pillow>=13\n' > /tmp/monkeybot-overrides.txt
uv tool install --overrides /tmp/monkeybot-overrides.txt monkeybot-cli

monkeybot new --dest ./my-agent --provider openai --yes
cd my-agent
uv sync
cp .env.example .env   # add provider keys
monkeybot doctor
monkeybot chat

Upgrade the CLI with the same override: uv tool install --reinstall --overrides /tmp/monkeybot-overrides.txt monkeybot-cli. Full walkthrough: Getting Started.

What you get

  • SSE gateway — sessions, streaming, health; wire your own UI or use the CLI
  • Realtime talk — WebSocket voice/text via monkeybot talk
  • MCP + skills — stdio/HTTP tools and trusted Python skill bundles
  • Pluggable storage — SQLite by default; Postgres, Firestore, GCS, S3
  • Multi-provider — Gemini/Vertex, OpenAI, Anthropic, Bedrock, Ollama, and more

CLI

Command Purpose
monkeybot new Scaffold config, workspace, agent pyproject.toml, .env.example
monkeybot validate Check monkeybot.yaml, paths, and MCP config
monkeybot doctor Verify Python, extras, credentials, and port
monkeybot run Start the SSE gateway in the foreground
monkeybot chat Talk over SSE (spawns the gateway; --attach to join one)
monkeybot talk Realtime voice/text over WebSocket (--text for typed input)
monkeybot chat            # spawn gateway + REPL
monkeybot run             # terminal 1: gateway with logs
monkeybot chat --attach   # terminal 2: attach to it

Provider extras live on the agent pyproject.toml (monkeybot[<provider>]), not the global CLI. See Getting Started and Features — CLI.

Agent skill

npx skills add human-plus-machine/monkeybot --skill monkeybot

Walks through install, scaffold, config, and first chat. Source: cli/skills/monkeybot/.

Documentation

Guide Description
Getting Started Install, configure, sessions + SSE from the CLI
Configuration Every YAML option, allowed value, and default
Features Architecture, capabilities, CLI, task queue
SSE gateway and custom UI HTTP + SSE endpoints, event types, CORS
Skills Skill directory layout and SKILL.md discovery
Model Context Protocol MCP config, env interpolation, OAuth2
Cloud deployment Positioning + Patterns A–D index
Live evals Local T4 smoke suite and scorecard
Observability OpenTelemetry tracing runbook

Integrations matrix and roadmap: CHANGELOG · BACKLOG.

Contributing

Clone only if you are changing the harness. Setup, checks, and the release workflow are in CONTRIBUTING.md. Live eval smoke agent: regression/t4/agent/.

Support

Search or open an issue in the GitHub issue tracker.

Credits

MonkeyBot builds on two open-source projects:

License

MIT — see LICENSE.

Metadata

Release files for monkeybot 3.15.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for monkeybot 3.15.3
File Size Uploaded Provenance Actions
monkeybot-3.15.3.tar.gz 5.0 MB With provenance Details for monkeybot-3.15.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for monkeybot 3.15.3
File Interpreter ABI Platform Actions
monkeybot-3.15.3-py3-none-any.whl Python 3 none any Details for monkeybot-3.15.3-py3-none-any.whl

Total release size: 5.9 MB

Release files / monkeybot-3.15.3.tar.gz

Download URL monkeybot-3.15.3.tar.gz
Size 5.0 MB
Tags Source
SHA-256 checksum
How to use checksums
0edd9935981adbf5185bd2d8924f56864160ef12cd0bfa6ffe36339383a1c12e
BLAKE2b-256 checksum
How to use checksums
ce7af4bb537909698f3a668d528a7e8a3a1b2c9bb08532c4b9656726e6edf514
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / monkeybot-3.15.3-py3-none-any.whl

Download URL monkeybot-3.15.3-py3-none-any.whl
Size 927.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
053558a9a164cb6281320d0a26fc8d458f3b3a6f7780a9a3719ba7526d91da85
BLAKE2b-256 checksum
How to use checksums
86982c9e8d894e2f08bf1a3644eb43ce6050948ed5b50611ca65ff13e3b1edfd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for monkeybot 3.15.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for monkeybot-3.15.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page