Skip to main content

Babelagent

PyPI Docs DOI License: MIT

The Babel that lets AI agents understand each other. One shared tongue for agents that were never meant to talk.

Every agent framework has its own idea of what an agent is. LangChain has Runnables with .invoke, CrewAI has Crews with .kickoff, AutoGen has agents with .generate_reply, an LLM has messages.create, a microservice has an HTTP route. None of them agree on a shape, so connecting any two means writing glue.

Babelagent is the neutral layer in between. You bring your own agents, whatever they are (a callable, an HTTP/OpenAPI endpoint, an MCP tool, a framework agent, or an LLM), and it wraps each one in a single shared interface so they can exchange messages and collaborate on a task, agent-to-agent (A2A). The value is not any single adapter. It is that once something is adapted, it works with everything else you have adapted.

The headline is adapt(): hand Babelagent almost anything and it builds the connector on the fly.

import asyncio
from babelagent import Graph

async def main():
    graph = (
        Graph()
        .node("clean",   str.strip)
        .node("shout",   str.upper)
        .node("exclaim", lambda s: s + "!")
    )
    result = await graph.run("  hello  ")
    print(result.output)   # "HELLO!"

asyncio.run(main())

Let different agents work in parallel and hand their results to each other, with barrier policies on the join:

from babelagent import Graph, adapt

g = Graph()
g.node("src",     lambda text: text)
g.node("summary", adapt(langchain_agent), after=["src"])   # a LangChain agent
g.node("labels",  adapt("https://api.example.com/classify"), after=["src"])  # an HTTP service
# merge receives {"summary": ..., "labels": ...} keyed by node name (>=2 upstreams)
g.join("merge", after=["summary", "labels"], agent=combine, barrier="all")
result = await g.run(document)

Concepts

Concept What it is
Graph Builds the network of agents (linear chaining and a DAG API)
CompiledGraph The validated, runnable graph; await graph.run(payload)
Node One participant: an agent plus an optional quality check/gate
Agent The uniform async run(message, ctx) -> message interface
adapt() Turns any brought object into an Agent, inferring the adapter
Message / Result The envelope agents exchange / the final output + run trace
Barrier Fan-in join policy: all · k_of_n · optional

Install

pip install babelagent                 # light base (callables + HTTP)
pip install "babelagent[mcp]"          # MCP tools
pip install "babelagent[cloud]"        # Anthropic / OpenAI
pip install "babelagent[ollama]"       # local models
pip install "babelagent[frameworks]"   # LangChain (CrewAI/AutoGen detected if installed)
pip install "babelagent[serve]"        # REST service
pip install "babelagent[all]"

Try it (no API key)

babelagent demo      # a broken agent (gated FAIL) then a fixed one (PASS)
babelagent doctor    # which adapter families are available
babelagent inspect   # print a graph's topology as JSON

Cite

If you use Babelagent, please cite it (concept DOI, always resolves to the latest version):

Amit Patole. Babelagent. https://doi.org/10.5281/zenodo.22129957

A machine-readable CITATION.cff is in the repo.

Status

Alpha, in active development. MIT licensed.

— amitpatole

Download files

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

Source Distribution

babelagent-0.1.3.tar.gz (242.8 kB view details)

Uploaded Source

Built Distribution

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

babelagent-0.1.3-py3-none-any.whl (43.8 kB view details)

Uploaded Python 3

File details

Details for the file babelagent-0.1.3.tar.gz.

File metadata

  • Download URL: babelagent-0.1.3.tar.gz
  • Upload date:
  • Size: 242.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for babelagent-0.1.3.tar.gz
Algorithm Hash digest
SHA256 2b5cd79a17ca1adda4b8576c6ca4fd9e0a2309501d2f2c4316860d4526574163
MD5 c78f7d464cc9635bd0129f7deec899ae
BLAKE2b-256 43cae1507b9957ca6321c7864baee53c833eaf9c3ff1fe593d87b1ba69b78929

See more details on using hashes here.

Provenance

The following attestation bundles were made for babelagent-0.1.3.tar.gz:

Publisher: publish.yml on amitpatole/babelagent

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

File details

Details for the file babelagent-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: babelagent-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 43.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for babelagent-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 96575f2a13e5918baccf81b34a5d5a7f818fcd06cb6e5eb7564be2329a45eeb5
MD5 b5d09e79ce41d5e8872c87b56f52e66a
BLAKE2b-256 e084b15291706439d1420647b2e62408bdf7717489b1863a81470ab91e6fd98d

See more details on using hashes here.

Provenance

The following attestation bundles were made for babelagent-0.1.3-py3-none-any.whl:

Publisher: publish.yml on amitpatole/babelagent

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.1.3 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

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