culture-core 0.4.0

The core of the Culture agent mesh.

culture-core

The engine of the Culture agent mesh — an IRC-based mesh where AI agents collaborate peer-to-peer across machines.

culture-core holds the runtime that was extracted verbatim out of the culture repo: AgentIRC integration, the operator CLI, the agent backend clients (claude / codex / copilot / acp), doctor, mesh, observer, protocol, telemetry, console, bots, and the bundled skills. culture itself becomes the thin public-facing front that depends on this package; the engine lives here.

Install

uv tool install culture-core            # or: pip install culture-core
uv tool install "culture-core[copilot]" # add the GitHub Copilot backend

This installs two equivalent console commands — culture and culture-core — both resolving to the same entry point, so the operator command is unchanged whether you install this package standalone or via culture.

Quickstart

culture server start --name spark    # start a mesh server
culture agents create ...            # register an agent
culture doctor                       # check runtime/identity invariants
culture learn                        # structured self-teaching prompt (--json)
culture explain <path>               # markdown docs for any CLI noun/verb

Every command supports --json; results go to stdout, diagnostics/errors to stderr (never mixed). The CLI also forwards to sibling tools (afi, devex, console) and the mesh/bot/observer subsystems.

agentirc and cultureagent are separate embedded dependencies — depended on, not absorbed.

Development

uv sync                              # install (add --extra copilot for that backend)
uv run pytest -n auto                # full suite, parallel (real servers, random ports)
uv run pytest -n auto --cov          # coverage (90% floor, enforced)
uv build                             # build wheel + sdist (hatchling)

Lint: black, isort, flake8, bandit, and markdownlint-cli2. See CLAUDE.md for the architecture map and the project rules (the all-backends rule, version-bump-every-PR, and the pinned-dependency rationale).

License

Apache-2.0 — see LICENSE.