Metadata-Version: 2.4
Name: agentic-graph-composer
Version: 0.1.0
Summary: A CLI- and canvas-first builder for AI agents on LangGraph.
Project-URL: Homepage, https://github.com/rishav91/AgenticGraphComposer
Project-URL: Repository, https://github.com/rishav91/AgenticGraphComposer
Project-URL: Documentation, https://github.com/rishav91/AgenticGraphComposer/tree/main/docs
Project-URL: Changelog, https://github.com/rishav91/AgenticGraphComposer/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/rishav91/AgenticGraphComposer/issues
Author-email: Rishav Raushan <ris.rau111@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent-framework,agents,cli,langgraph,llm,yaml
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: click<9,>=8
Requires-Dist: langchain<0.4,>=0.3
Requires-Dist: langgraph-checkpoint-sqlite<3,>=2
Requires-Dist: langgraph<0.3,>=0.2
Requires-Dist: opentelemetry-exporter-otlp-proto-http<2,>=1.20
Requires-Dist: opentelemetry-sdk<2,>=1.20
Requires-Dist: pydantic<3,>=2
Requires-Dist: python-dotenv<2,>=1
Requires-Dist: pyyaml<7,>=6
Provides-Extra: dev
Requires-Dist: mypy<2,>=1.11; extra == 'dev'
Requires-Dist: pytest-cov<6,>=5; extra == 'dev'
Requires-Dist: pytest<9,>=8; extra == 'dev'
Requires-Dist: ruff<1,>=0.6; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Provides-Extra: examples
Requires-Dist: langchain-anthropic<0.4,>=0.3; extra == 'examples'
Requires-Dist: langchain-openai<0.4,>=0.3; extra == 'examples'
Provides-Extra: postgres
Requires-Dist: langgraph-checkpoint-postgres<3,>=2; extra == 'postgres'
Requires-Dist: psycopg[binary]<4,>=3; extra == 'postgres'
Description-Content-Type: text/markdown

# Agentic Graph Composer

A CLI- and canvas-first builder for AI agents on LangGraph.
Define an agent as a declarative YAML schema; Agentic Graph Composer compiles it into a real LangGraph
`StateGraph` - not a reimplementation of LangGraph, a thin, typed layer on top of it.

[![PyPI](https://img.shields.io/pypi/v/agentic-graph-composer)](https://pypi.org/project/agentic-graph-composer/)
[![CI](https://github.com/rishav91/AgenticGraphComposer/actions/workflows/ci.yml/badge.svg)](https://github.com/rishav91/AgenticGraphComposer/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

## Install

```sh
pip install agentic-graph-composer
```

This installs the `agc` command.

## Quickstart

```sh
mkdir my-agent && cd my-agent
agc init                       # scaffolds a working schema.yaml + starter files
cp .env.example .env                  # then fill in your provider's API key
agc validate schema.yaml
agc run schema.yaml "What does this project do?"
```

`agc doctor schema.yaml` checks your environment (API keys, optional extras, checkpointer
config) against what a schema actually needs, before you hit a failure mid-run.

## The canvas (visual editor)

A visual editor for the graph a schema compiles to ships bundled in - no separate install, no
Node.js needed:

```sh
agc canvas schema.yaml
```

This prints a URL - open it in a browser to see and edit the graph, backed by the same
schema/compiler library the CLI uses. See [canvas/README.md](canvas/README.md) for the view-only
mode and running the canvas from source.

## What a schema looks like

```yaml
schema_version: 1
nodes:
  - id: assistant
    llm:
      provider: anthropic
      model: claude-sonnet-5
      system: "You are a helpful assistant."
    tools:
      - tools:search_docs
```

A schema with exactly one node and no `edges` section is implicitly wired `START -> node -> END`.
Multi-node graphs add explicit `edges` (direct or conditional), a `handler` node for custom-code
logic outside the schema, and an opt-in `checkpointer` block for resumable runs.
See [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) for the full setup guide - extras, provider
API keys, Postgres checkpointing, observability.
See [docs/README.md](docs/README.md) for the complete design-doc suite.

## Optional extras

```sh
pip install "agentic-graph-composer[examples]"   # langchain-anthropic, langchain-openai - to run examples/
pip install "agentic-graph-composer[postgres]"   # Postgres-backed checkpointing
```

## Learn more

- [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) - the practical setup guide
- [docs/README.md](docs/README.md) - architecture, ADRs, requirements, roadmap
- [CONTRIBUTING.md](CONTRIBUTING.md) - developing Agentic Graph Composer itself
- [CHANGELOG.md](CHANGELOG.md)

## License

[MIT](LICENSE)
