X Company Banner Black

Overmind

Overmind is two things in one package:

  • Tracing SDK — drop-in observability for LLM agents. Decorate your code, get structured traces of every LLM call and tool invocation.
  • Optimiser client — a thin, agent- and codebase-agnostic executioner. The optimisation loop (experiments → iterations → candidates → commands) is configured and driven server-side by the Overmind Console. This repo just registers your machine, leases queued commands, runs them against your repo, and reports results back.

Documentation: Overmind guide

Console: console.overmindlab.ai

Install

uv tool install overmind
# or
pipx install overmind

Tracing

Wire up tracing once at process start, then annotate the functions you want traced:

import overmind

overmind.init(service_name="my-agent", providers=["openai", "anthropic"])  # reads OVERMIND_API_KEY from the environment

@overmind.entry_point()
def run(input_data: dict) -> dict:
    return {"response": handle(input_data)}

@overmind.tool()
def search(query: str) -> list[dict]:
    ...

Available decorators/helpers: entry_point, workflow, tool, function, plus start_span (context manager), set_tag, set_user, and capture_exception for Sentry-style annotations on the current span.

Optimise

Set up and configure the experiment (agent, policy, dataset, iterations) in the Console. Then, from the root of the repo you want optimised:

export OVERMIND_API_KEY=<your-api-key>
overmind optimise

This registers the current machine with the backend and loops forever: it leases queued commands from the experiment you configured in the Console, checks out the iteration's git branch (applying its candidate diff as a commit), runs the shell command against your repo, and reports the result back. Stop it any time with Ctrl-C; re-running is safe and idempotent per iteration branch.

Options / environment variables

Flag Env var Default Description
--api-key OVERMIND_API_KEY (required) Sent as X-Api-Key.
--api-url OVERMIND_API_URL https://api.overmindlab.ai Backend base URL.
--cwd OVERMIND_CWD current directory Repo root to run commands in.
--poll-interval OPTIMIZER_POLL_INTERVAL 5 Idle poll seconds.
--heartbeat-interval OPTIMIZER_HEARTBEAT_INTERVAL 60 Idle "still alive" log interval, seconds.
--log-level OPTIMIZER_LOG_LEVEL INFO DEBUG/INFO/WARNING/ERROR.

[!WARNING] The Console can hand this client arbitrary shell to run (shell=True, guarded only by a per-command timeout). Only point it at a backend you trust.

Skills

Use these from Cursor, Codex, or Claude Code to scaffold agents and configure telemetry without leaving your coding environment. Skills live at the repo-root skills/ directory so agent installers can pick them up from this repository (e.g. npx skills add overmind-core/overmind).

overmind skills list --verbose
overmind skills sync "Overmind Telemetry"   # or: overmind-agent-telemetry
Skill What it does
Overmind Telemetry Add tracing, verify traces via the REST API, and look up current Overmind docs (overmind-agent-telemetry).

CLI reference

overmind optimise [OPTIONS]         Register this machine and run the optimisation loop
overmind skills list [--verbose]    List installed/available skills
overmind skills sync <name>...      Sync one or more skills to the latest version

Run overmind <command> --help for full flag documentation.

Project links

Data verified by PyPI on Aug 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.67)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for pritam-overmind from gravatar.com pritam-overmind

Credits

Author: Overmind Ltd

GitHub Statistics

Data verified by PyPI on Aug 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python <4, >=3.10

Provides Extra

test

Tags

ai api client enforcement overmind policy

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

overmind-0.1.58.tar.gz (267.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

overmind-0.1.58-py3-none-any.whl (46.3 kB view details)

Uploaded Python 3

File details

Details for the file overmind-0.1.58.tar.gz.

File metadata

  • Download URL: overmind-0.1.58.tar.gz
  • Upload date:
  • Size: 267.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for overmind-0.1.58.tar.gz
Algorithm Hash digest
SHA256 2c53acf0ef63d652027f0cb923bade8e8fb29da84fd55c0978ea62cad06cb33f
MD5 43c8c9a0b6bb6f737258dc072455b6ab
BLAKE2b-256 db3bcbf79ec4300025be4a9d9a488da2b91c34239c412090d21a2c40430aa3a3

See more details on using hashes here.

Provenance

The following attestation bundles were made for overmind-0.1.58.tar.gz:

Publisher: publish.yml on overmind-core/overmind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file overmind-0.1.58-py3-none-any.whl.

File metadata

  • Download URL: overmind-0.1.58-py3-none-any.whl
  • Upload date:
  • Size: 46.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for overmind-0.1.58-py3-none-any.whl
Algorithm Hash digest
SHA256 710c086c14e81e76fbad13cea8006770d478ff4a5f3a7890fcf864d979f36b7f
MD5 72f748ba5b152cfb563e2b5c7eb89019
BLAKE2b-256 99d0278b93cc624138eef394b3fd6f066ccd02023b900b59e82f096edb99da83

See more details on using hashes here.

Provenance

The following attestation bundles were made for overmind-0.1.58-py3-none-any.whl:

Publisher: publish.yml on overmind-core/overmind

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.67

2 files

0.1.66

2 files

0.1.65

2 files

0.1.64

2 files

0.1.63

2 files

0.1.62

2 files

0.1.61

2 files

0.1.60

2 files

0.1.59

2 files

This release

0.1.58 This release

2 files

0.1.57

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.49

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.45

2 files

0.1.40

2 files

0.1.39

2 files

0.1.31

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page