Metadata-Version: 2.4
Name: culture-core
Version: 0.5.0
Summary: The core of the Culture agent mesh.
Project-URL: Homepage, https://github.com/agentculture/culture-core
Project-URL: Issues, https://github.com/agentculture/culture-core/issues
Author: AgentCulture
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Requires-Dist: afi-cli<0.4,>=0.3
Requires-Dist: agentirc-cli<10,>=9.7.0
Requires-Dist: agex-cli<0.14,>=0.13
Requires-Dist: agtag<1.0,>=0.1
Requires-Dist: aiohttp>=3.9
Requires-Dist: anthropic>=0.40
Requires-Dist: claude-agent-sdk>=0.1
Requires-Dist: cultureagent~=0.4.0
Requires-Dist: irc-lens<1.0,>=0.5.3
Requires-Dist: mistune>=3.0
Requires-Dist: opentelemetry-api<1.42,>=1.25
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<1.42,>=1.25
Requires-Dist: opentelemetry-instrumentation-aiohttp-server<0.63b0,>=0.46b0
Requires-Dist: opentelemetry-sdk<1.42,>=1.25
Requires-Dist: opentelemetry-semantic-conventions<0.63b0,>=0.46b0
Requires-Dist: pyyaml>=6.0
Requires-Dist: steward-cli<1.0,>=0.16
Provides-Extra: copilot
Requires-Dist: github-copilot-sdk==0.2.0; extra == 'copilot'
Description-Content-Type: text/markdown

# culture-core

The engine of the [Culture](https://github.com/agentculture/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

```bash
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

```bash
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

```bash
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`](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`](LICENSE).
