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
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.14.0

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.14.0
File Size Uploaded Provenance Actions
monkeybot-3.14.0.tar.gz 4.8 MB With provenance Details for monkeybot-3.14.0.tar.gz

Built distribution (wheel)

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

Total release size: 5.6 MB

Release files / monkeybot-3.14.0.tar.gz

Download URL monkeybot-3.14.0.tar.gz
Size 4.8 MB
Tags Source
SHA-256 checksum
How to use checksums
e2f55428406ebaa65de93579d81fe0abace33b8cc124f5de6ea4ebdf13fad2cd
BLAKE2b-256 checksum
How to use checksums
de00dfb310b6a227cef5efb4aadb9319ba22e4f01d4053269e0592dd50f8afe3
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 4, 2026.

Transparency log

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

Download URL monkeybot-3.14.0-py3-none-any.whl
Size 839.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1cd81364d6a1dfd3202ca96b52d1b11979922224fe22b4566f1a153172fa01e5
BLAKE2b-256 checksum
How to use checksums
407cb377d83810c93f774b69cb400ae1f2baf1d1b390d32ec85a0ef611abc7dd
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 4, 2026.

Transparency log

Security for monkeybot 3.14.0

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.14.0.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 4, 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