Skip to main content

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.

Metadata

Release files for culture-core 0.17.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 culture-core 0.17.0
File Size Uploaded Provenance
culture_core-0.17.0.tar.gz 665.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for culture-core 0.17.0
File Interpreter ABI Platform
culture_core-0.17.0-py3-none-any.whl Python 3 none any Details

Total release size: 868.5 kB

Release files / culture_core-0.17.0.tar.gz

Download URL culture_core-0.17.0.tar.gz
Size 665.1 kB
Tags Source
SHA-256 checksum
How to use checksums
66c4fcb1e42b164064daec2186639bc34d86631a5138ab68910b28da3029864c
BLAKE2b-256 checksum
How to use checksums
27a8e44f00530337d4ada552c8448879f1fd7b5ebd671c8c7c0becb105ae2c2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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 / culture_core-0.17.0-py3-none-any.whl

Download URL culture_core-0.17.0-py3-none-any.whl
Size 203.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2a21f0e273eb2b16291af68101e4c102385744705f359db9aa5467f6c9e05a22
BLAKE2b-256 checksum
How to use checksums
6d43362d73b1e7bd3e1b767650310d0f0e5dfef968c3402718f75c45ca16df63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","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}

Security for culture-core 0.17.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

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