🐮 Calfkit

Build decentralized multi-agent systems. Agents discover each other at runtime, choreograph work, and scale as independent, event-driven services.

License PyPI version PyPI downloads Python versions codecov Ask DeepWiki

Calfkit agents find each other and choreograph work over a mesh — a highly-connected data streaming network they auto-discover and communicate on. Each agent runs as an independent, event-driven service, so you can build free-flowing multi-agent workflows that collaborate and react to live data streams.


Why Calfkit?

  • Dynamic agent-to-agent discovery and collaboration. Agents find each other at runtime and work together — messaging each other and handing off tasks — so you build multi-agent systems without complex wiring or orchestration, and extend team capabilities at any time.
  • Scalable by default. Every agent runs and scales as an independent microservice, so your agent teams are resilient and scalable from day one.
  • React to realtime data streams. Agents are event-driven, so they react to realtime data streams — live market feeds, log streams, support-ticket queues — and send results wherever they're needed. Build agents that work like continuously streaming workflows, not one-off requests.
  • Scale on production-ready infrastructure. The agent mesh is Kafka-compatible so you can run + scale your agents on production-ready streaming infrastructure straight out of the box.

Installation

# Recommended for getting started, includes a zero-setup in-memory dev mesh:
pip install 'calfkit[mesh]'

Quickstart

With the [mesh] extra, ck dev spins up a local in-memory mesh for you — no Docker, no CALFKIT_MESH_URL required.

Agent

Save as general.py:

from calfkit import Agent, Handoff, Messaging, OpenAIResponsesModelClient

general = Agent(
    name="general",
    description="Answers simple questions and routes requests to whoever can handle it.",
    system_prompt="You are a general assistant. Defer technical questions to other agents.",
    model_client=OpenAIResponsesModelClient(model_name="gpt-5.4"),
    peers=[
        Messaging(discover=True),  # discover and delegate to any agent at runtime
        Handoff(discover=True),    # discover and hand off to any agent at runtime
    ],
)

Run it and chat

# Starts the agent (and a local mesh if one isn't running):
#   ck dev run <file>:<agent>
ck dev run general:general

# In a second terminal, chat with the agent:
ck dev chat

Add another agent — and watch them discover each other

Save as finance.py:

from calfkit import Agent, OpenAIResponsesModelClient

finance = Agent(
    name="finance",
    description="Answers the user's personal finance questions.",
    system_prompt="You are the personal finance specialist. Answer finance-related questions.",
    model_client=OpenAIResponsesModelClient(model_name="gpt-5.4"),
)

ck dev run finance:finance

Now ask a finance question in ck dev chat — general discovers finance at runtime and hands off automatically. No wiring, no orchestrator.

Running an agent mesh

Calfkit agents discover and communicate over a mesh.

For local dev, the bundled in-memory broker (via [mesh] extra) is zero-setup — see How to run a local mesh with ck dev.

In production, the mesh is Kafka-compatible so you can drop your agent swarms into production-ready Kafka streaming infrastructure you already use.

Want a fully-managed mesh your agents can join from anywhere? Join the beta

Documentation

  • Getting started: See docs/.
  • Examples: See examples/ — multi-agent team and general framework API examples.

Contributing

Issues and pull requests are welcome. Please open an issue to discuss substantial changes before sending a PR.

See CONTRIBUTING.md.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Project links

Data verified by PyPI on Jul 20, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ryan_yu from gravatar.com ryan_yu

Credits

Author: Calf AI

GitHub Statistics

Data verified by PyPI on Jul 20, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Provides Extra

mesh

Tags

agents ai decoupled distributed event-driven kafka llm workflows

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

calfkit-0.13.0.tar.gz (1.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

calfkit-0.13.0-py3-none-any.whl (870.1 kB view details)

Uploaded Python 3

File details

Details for the file calfkit-0.13.0.tar.gz.

File metadata

  • Download URL: calfkit-0.13.0.tar.gz
  • Upload date:
  • Size: 1.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for calfkit-0.13.0.tar.gz
Algorithm Hash digest
SHA256 74f9d205da029b1ac7c87ef53410b03124e42e2d29dbffa254cd4ca824e22a99
MD5 05644786c5a066f478c90bef0497d27c
BLAKE2b-256 43a307c47cbb5d726b887411f5e01e680ddd077628921fac2f383aa9eefe5c1c

See more details on using hashes here.

Provenance

The following attestation bundles were made for calfkit-0.13.0.tar.gz:

Publisher: release.yml on calf-ai/calfkit-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file calfkit-0.13.0-py3-none-any.whl.

File metadata

  • Download URL: calfkit-0.13.0-py3-none-any.whl
  • Upload date:
  • Size: 870.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for calfkit-0.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f1d1a18f070c56f4c1a38001b688e8bec58fe0f778e9e1f9d6b090777dd50502
MD5 789ce48019767340cc27e03c90958ea7
BLAKE2b-256 505523905bdfdff16f800849cf1abdd472b57dc94f8091047b54e6f5f08ebf17

See more details on using hashes here.

Provenance

The following attestation bundles were made for calfkit-0.13.0-py3-none-any.whl:

Publisher: release.yml on calf-ai/calfkit-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.13.0 This release

2 files

0.12.10

2 files

0.12.9

2 files

0.12.8

2 files

0.12.7

2 files

0.12.6

2 files

0.12.5

2 files

0.12.4

2 files

0.12.3

2 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.1

2 files

0.4.0

2 files

0.3.6

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

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