https://github.com/calf-ai/calfkit-mesh
Deploy event-driven, distributed AI agents with Calfkit broker
https://github.com/calf-ai/calfkit-mesh
agents agents-sdk ai ai-agents ai-employees ai-workflows asynchronous-communication broker chatgpt event-driven kafka llm openai pydantic-ai python
Last synced: 12 days ago
JSON representation
Deploy event-driven, distributed AI agents with Calfkit broker
- Host: GitHub
- URL: https://github.com/calf-ai/calfkit-mesh
- Owner: calf-ai
- License: apache-2.0
- Created: 2026-01-07T03:18:05.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-07-07T19:38:54.000Z (17 days ago)
- Last Synced: 2026-07-12T22:32:20.584Z (12 days ago)
- Topics: agents, agents-sdk, ai, ai-agents, ai-employees, ai-workflows, asynchronous-communication, broker, chatgpt, event-driven, kafka, llm, openai, pydantic-ai, python
- Language: Python
- Homepage:
- Size: 43.9 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Notice: NOTICE
Awesome Lists containing this project
README
# 🐮 Calfkit Mesh
[](https://github.com/calf-ai/calfkit-sdk) [](https://pypi.org/project/calfkit-mesh/) [](https://github.com/calf-ai/calfkit-mesh/blob/main/LICENSE)
Local Kafka infrastructure for event-driven and distributed AI agent development using [Calfkit SDK](https://github.com/calf-ai/calfkit-sdk).
Provides two-tier Kafka environments using KRaft:
| Tier | Use Case | Startup | Command |
|------|----------|---------|---------|
| **Tier 1** | Daily development | ~10 seconds | `make dev-up` |
| **Tier 2** | Integration testing | 3-5 minutes | `make k8s-up` |
## Quick Start
### Start up the broker (using Docker)
```bash
# Start Kafka for local development
make dev-up
# Kafka available at localhost:9092
# Stop
make dev-down
```
## Kafka UI (optional)
```bash
# Start Kafka UI (connects to existing broker at localhost:9092)
make ui
# UI available at http://localhost:8080
# Stop
make ui-down
```
## `calfkit-mesh` pip package
For a zero-dependency local broker, this repo also publishes the
**`calfkit-mesh`** Python package. It bundles a static, memory-only build of the
[Tansu](https://github.com/tansu-io/tansu) broker (Apache Kafka-compatible)
inside platform wheels, so `calfkit`'s `ck dev` can spawn a broker without
Docker, JVM, or any network install:
```bash
pip install calfkit-mesh
```
This is the upstream of calfkit's opt-in `[mesh]` extra. The package exposes a
single locator, `calfkit_mesh.resolve_broker_bin()`, which returns the path to a
usable `tansu` executable using this resolution order:
1. **`$CALF_TANSU_BIN`** — if set, it is used verbatim (and must point at an
executable file, or resolution fails). Use this to point `ck dev` at your own
`tansu` build.
2. **The wheel-bundled binary** — materialized once to a stable cache path
(`~/.calfkit/bin/tansu-`) and made executable.
3. **`tansu` on your `PATH`**.
Wheels are built for Linux (`x86_64`, `aarch64`; published under both `manylinux`
and `musllinux` tags), macOS (`arm64`, `x86_64`), and Windows (`x86_64`).
## License
Apache 2.0 - see [LICENSE](LICENSE).
The Tansu binary bundled in calfkit-mesh wheels is also Apache 2.0; see
[NOTICE](NOTICE) for attribution.