Loom

Split complex AI work into focused steps. Test them individually. Chain them into workflows. Scale when you need to.

Try It in 60 Seconds

pip install loom-ai[rag]                              # install from PyPI
loom setup                                            # configure (auto-detects Ollama)
loom rag ingest /path/to/telegram/exports/*.json
loom rag search "earthquake damage reports"
loom rag serve                                        # open dashboard at localhost:8080

Or from source:

git clone https://github.com/IranTransitionProject/loom.git && cd loom
uv sync --extra rag
uv run loom setup

No servers to run. No configuration files to write. The setup wizard handles everything.

What Loom Does

Instead of one giant AI prompt that tries to do everything, Loom lets you break work into small, focused steps — each with a clear job, testable independently, and using the right model for the task.

  Document ──► Extract ──► Classify ──► Summarize ──► Report
                 │            │            │
                 │            │            └─ Claude Opus (complex reasoning)
                 │            └─ Ollama local (fast, free)
                 └─ Ollama local (fast, free)

Steps can run in parallel, use different AI models, and be tested with the built-in Workshop web UI — all without deploying any infrastructure.

When you're ready to scale, Loom adds a message bus (NATS) that connects everything for production use.

Who This Is For

Researchers and analysts — analyze social media streams, extract data from documents, build knowledge graphs. Start with loom rag and the Workshop dashboard. No infrastructure knowledge needed.

AI engineers — build multi-step LLM workflows with typed contracts, tool-use, knowledge injection, and pipeline orchestration. Test everything locally before deploying.

Platform teams — deploy to Kubernetes with rate limiting, model tier management, dead-letter handling, and OpenTelemetry tracing. Scale any component independently.

Three Ways to Use Loom

1. Command line (no setup)

Ingest data, search, and analyze — all from the terminal:

uv run loom rag ingest exports/*.json    # ingest Telegram channels
uv run loom rag search "protest reports"  # semantic search
uv run loom rag stats                     # store statistics

2. Build your own steps (guided)

Scaffold workers and pipelines interactively — YAML is generated for you:

uv run loom new worker                   # create a step from prompts
uv run loom new pipeline                 # chain steps into a workflow
uv run loom validate configs/workers/*.yaml  # check your configs
uv run loom workshop --port 8080         # test and evaluate in the web UI

Six ready-made workers ship with Loom: summarizer, classifier, extractor, translator, qa (question answering with source citations), and reviewer (quality review against configurable criteria).

3. Distributed infrastructure (production)

For teams, continuous processing, or high-throughput scenarios:

uv run loom router --nats-url nats://localhost:4222
uv run loom worker --config configs/workers/summarizer.yaml --tier local
uv run loom pipeline --config configs/orchestrators/my_pipeline.yaml
uv run loom submit "Analyze the quarterly reports"

Scale any component by running more copies — NATS load-balances automatically.

Key Features

Documentation

Start here:

Go deeper:

Current State

Get Involved

Use it. Start with uv run loom setup and go from there.

Contribute. New step types, contrib packages, test coverage, and docs are welcome. See Contributing.

Report issues. Bug reports with reproducible steps help the most.

AI-Assisted Development

This project uses Claude (Anthropic) as a development tool. CLAUDE.md documents the architecture and design rules for AI-assisted sessions. AI-generated code meets the same standards as human contributions: typed messages, stateless workers, validated contracts, tests.

License

MPL 2.0 — Modified source files must remain open; unmodified files can be combined with proprietary code. Alternative licensing available for organizations with copyleft constraints. Contact: admin@irantransitionproject.org

For governance, succession, and contributor rights, see GOVERNANCE.md.