orka-reasoning 0.9.14
Modular agent orchestrator for reasoning pipelines
Requires Python: >=3.11

<p align="center">

<img src="https://orkacore.com/assets/orka_logo_white.png" alt="OrKa Logo" style="border-radius: 25px; width: 400px; height:400px" />

[![GitHub Tag](https://img.shields.io/github/v/tag/marcosomma/orka-reasoning?color=blue)](https://github.com/marcosomma/orka-reasoning/tags)
[![PyPI - License](https://img.shields.io/pypi/l/orka-reasoning?color=blue)](https://pypi.org/project/orka-reasoning/)

[![Unit Tests](https://github.com/marcosomma/orka-reasoning/actions/workflows/tests.yml/badge.svg)](https://github.com/marcosomma/orka-reasoning/actions/workflows/tests.yml) [![Lint](https://github.com/marcosomma/orka-reasoning/actions/workflows/lint.yml/badge.svg)](https://github.com/marcosomma/orka-reasoning/actions/workflows/lint.yml)

<!-- [![codecov](https://img.shields.io/badge/codecov-76.97%25-yellow?&amp;logo=codecov)](https://codecov.io/gh/marcosomma/orka-reasoning) -->
[![codecov](https://codecov.io/github/marcosomma/orka-reasoning/branch/master/graph/badge.svg?token=V91X4WGBBZ)](https://codecov.io/github/marcosomma/orka-reasoning)
[![orka-reasoning](https://snyk.io/advisor/python/orka-reasoning/badge.svg)](https://snyk.io/advisor/python/orka-reasoning)

[![PyPi](https://img.shields.io/badge/pypi-%23ececec.svg?style=for-the-badge&amp;logo=pypi&amp;logoColor=1f73b7)](https://pypi.org/project/orka-reasoning/)[![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&amp;logo=docker&amp;logoColor=white)](https://hub.docker.com/r/marcosomma/orka-ui)[![Documentation](https://img.shields.io/badge/Docs-blue?style=for-the-badge&amp;logo=googledocs&amp;logoColor=%23fff&amp;link=https%3A%2F%2Forkacore.com%2Fdocs%2Findex.html)](https://orkacore.com/docs/index.html)

[![orkacore](https://img.shields.io/badge/orkacore-.com-green?labelColor=blue&amp;style=for-the-badge&amp;link=https://orkacore.com/)](https://orkacore.com/)


[![Pepy Total Downloads](https://img.shields.io/pepy/dt/orka-reasoning?style=for-the-badge&amp;label=Downloads%20from%20April%202025&amp;color=blue&amp;link=https%3A%2F%2Fpiptrends.com%2Fpackage%2Forka-reasoning)](https://clickpy.clickhouse.com/dashboard/orka-reasoning)
</p>

## Overview
OrKA-reasoning is a open-source, local‑first, YAML‑driven system for composing AI workflows. Define agents and control‑flow in configuration, run them with a single command, and keep everything observable and reproducible.

Think of it as a streamlined, open-source experimental framework with a strong focus on:
- YAML‑first workflows: declarative configs over code > see [YAML Configuration](docs/YAML_CONFIGURATION.md)
- Visual builder and runner (drag‑and‑drop) > see [OrKa UI](docs/orka-ui.md)
- Built‑in memory with vector search and decay > see [Memory System](docs/MEMORY_SYSTEM_GUIDE.md)
- Local and cloud LLM support with cost controls > see [Backends](docs/README_BACKENDS.md)
- Rich control flow (router, fork/join, loop, failover, plan validation) > see [Agents & Nodes](docs/AGENT_NODE_TOOL_INDEX.md)
- Path discovery with GraphScout (beta) > see [GraphScout](docs/GRAPH_SCOUT_AGENT.md)
- Structured JSON inputs for complex data > see [JSON Inputs](docs/JSON_INPUTS.md)
- Observability and tracing > see [Observability](docs/observability.md)
- Testing guidance and examples > see [Testing Guide](docs/TESTING.md)

## Get started

- Quickstart: [docs/quickstart.md](docs/quickstart.md)
- Documentation index: [docs/index.md](docs/index.md)
- Examples: [examples/](examples)

## Community

- Issues & feature requests: https://github.com/marcosomma/orka-reasoning/issues
- Contributing guide: [CONTRIBUTING.md](CONTRIBUTING.md)

## License

Apache 2.0 — see [LICENSE](LICENSE)