selectools

```
┌─┐┌─┐┬  ┌─┐┌─┐┌┬┐┌─┐┌─┐┬  ┌─┐
└─┐├┤ │  ├┤ │   │ │ ││ ││  └─┐
└─┘└─┘┴─┘└─┘└─┘ ┴ └─┘└─┘┴─┘└─┘
```

[![PyPI](https://img.shields.io/pypi/v/selectools?color=06b6d4&label=pypi)](https://pypi.org/project/selectools/)
[![Downloads](https://static.pepy.tech/badge/selectools/month)](https://pepy.tech/projects/selectools)
[![CI](https://github.com/johnnichev/selectools/actions/workflows/ci.yml/badge.svg)](https://github.com/johnnichev/selectools/actions/workflows/ci.yml)
[![Docs](https://img.shields.io/badge/docs-selectools.dev-06b6d4)](https://selectools.dev)
[![Python](https://img.shields.io/pypi/pyversions/selectools?color=06b6d4)](https://pypi.org/project/selectools/)
[![License](https://img.shields.io/badge/license-Apache_2.0-blue)](https://www.apache.org/licenses/LICENSE-2.0)
[![Evaluators](https://img.shields.io/badge/evaluators-50-06b6d4)](https://selectools.dev/modules/EVALS/)

An open-source project from **[NichevLabs](https://nichevlabs.com)**.

**Multi-agent orchestration in plain Python.** Build agent graphs, compose pipelines with `|`, deploy with one command. No DSL, no compile step, no paid debugger. Works with OpenAI, Anthropic, Gemini, and Ollama.

### 3 Ways to Build

```python
# 1. Single agent — 5 lines
agent = Agent(tools=[search, calculate], provider=OpenAIProvider())
result = agent.run("What is 15 * 7?")

# 2. Multi-agent graph — 1 line
result = AgentGraph.chain(planner, writer, reviewer).run("Write a blog post")

# 3. Deploy — 1 command
# selectools serve agent.yaml
```

## What's New in v0.22

### v0.22.0 — Competitor-Informed Bug Fixes

22 bugs identified by mining 95+ closed bug reports from [Agno](https://github.com/agno-agi/agno) (39k stars) and 60+ from [PraisonAI](https://github.com/MervinPraison/PraisonAI) (6.9k stars), then cross-referencing the patterns against selectools v0.21.0 source code. Six were shipping blockers. All 22 are now fixed with TDD regression tests.

```python
# BUG-02: typing.Literal now supported in @tool()
from typi