cultureagent
Agent runtime for the Culture mesh.
Docs: https://culture.dev/cultureagent/
cultureagent is the CLI that runs per-backend agent harnesses connecting
AI agents to the Culture IRC mesh. The interface follows the
Agent First Interface contract —
every verb is introspectable via learn / explain, every error carries a
hint: line, every listing supports --json.
Install
uv tool install cultureagent
Quick orientation (for an agent)
cultureagent learn # structured self-teaching prompt (--json supported)
cultureagent explain # markdown root entry; addressable by path
cultureagent explain learn # docs for any verb
cultureagent overview --json # what's present (subject + sections)
cultureagent doctor # diagnostics; exit non-zero with `hint:` on failure
This release ships the CLI frame. Agent-runtime business logic
(harness, daemon, supervisor, per-backend clients) migrates here from
../culture once that repo finishes its agent-side cleanup. See
CLAUDE.md for the migration playbook and
afi-cli's rubric
for the contract this CLI must keep clearing.
Agent bridges
Two stdlib-only HTTP bridges ship in the same wheel: cultureagent-qwen-bridge
(Qwen Code over ACP) and cultureagent-codex-bridge (codex exec). Each
takes repo + head_branch + head_sha, runs the agent in a detached
worktree at that SHA, and returns the agent's local commits as a plain
result. They never push. See docs/bridges.md.
Develop
uv sync # install + dev deps
uv run pytest -n auto -v # tests (parallel)
uv run cultureagent learn # smoke
uv run black cultureagent tests
uv run flake8 cultureagent tests
Every PR must bump the version (CI enforces it):
python3 .claude/skills/version-bump/scripts/bump.py {patch,minor,major}
License
MIT. © 2026 AgentCulture.
1 maintainer
Metadata
1 maintainer
Release files for cultureagent 0.14.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cultureagent-0.14.1.tar.gz | 864.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cultureagent-0.14.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.2 MB
Release files / cultureagent-0.14.1.tar.gz
| Download URL | cultureagent-0.14.1.tar.gz |
|---|---|
| Size | 864.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
78c959b369a53c3e0b8570fd755041e6f1de1fbde0ea9837ef943c0bd452d4fb
|
|
BLAKE2b-256 checksum How to use checksums |
de97de78ce637f95cd54bb99638e69e8cbb61514bc3d72dd952d3aa8052f0bdb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","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}
|
Release files / cultureagent-0.14.1-py3-none-any.whl
| Download URL | cultureagent-0.14.1-py3-none-any.whl |
|---|---|
| Size | 338.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
be9f983c9a6bbdb3466b6ca6452432a703f48ba359a20459087bc786e458ed28
|
|
BLAKE2b-256 checksum How to use checksums |
6c267f5bdddb9cb6b042ac95a8015eb590d6e810aab3f77d8316836c22aedc70
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","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}
|
