Metadata-Version: 2.4
Name: nomos
Version: 0.3.2
Summary: Configurable multi-step agent framework for building advanced LLM-powered assistants
Author-email: chandralegend <irugalbandarachandra@gmail.com>
License: MIT
Requires-Python: <4.0,>=3.10
Requires-Dist: colorama<0.5.0,>=0.4.6
Requires-Dist: docstring-parser<0.17,>=0.16
Requires-Dist: greenlet>=3.2.3
Requires-Dist: loguru<0.8.0,>=0.7.3
Requires-Dist: numpy>=2.2.6
Requires-Dist: pydantic-settings<3.0.0,>=2.9.1
Requires-Dist: pydantic<3.0.0,>=2.11.3
Requires-Dist: pyyaml<7.0.0,>=6.0.2
Provides-Extra: anthropic
Requires-Dist: anthropic<0.56.0,>=0.55.0; extra == 'anthropic'
Provides-Extra: cli
Requires-Dist: rich<14.0.0,>=13.0.0; extra == 'cli'
Requires-Dist: typer<0.17.0,>=0.16.0; extra == 'cli'
Provides-Extra: google
Requires-Dist: google-genai<2.0.0,>=1.12.1; extra == 'google'
Provides-Extra: groq
Requires-Dist: groq>=0.29.0; extra == 'groq'
Requires-Dist: instructor>=1.9.2; extra == 'groq'
Provides-Extra: huggingface
Requires-Dist: huggingface-hub>=0.32.0; extra == 'huggingface'
Provides-Extra: mcp
Requires-Dist: fastmcp>=2.7.1; extra == 'mcp'
Provides-Extra: mistralai
Requires-Dist: mistralai<2.0.0,>=1.7.0; extra == 'mistralai'
Provides-Extra: ollama
Requires-Dist: ollama>=0.5.1; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai<2.0.0,>=1.76.0; extra == 'openai'
Requires-Dist: tiktoken<0.10.0,>=0.9.0; extra == 'openai'
Provides-Extra: serve
Requires-Dist: asyncpg<0.31.0,>=0.30.0; extra == 'serve'
Requires-Dist: fastapi<0.116.0,>=0.115.12; extra == 'serve'
Requires-Dist: kafka-python>=2.2.15; extra == 'serve'
Requires-Dist: psycopg2-binary<3.0.0,>=2.9.10; extra == 'serve'
Requires-Dist: redis<7.0.0,>=6.2.0; extra == 'serve'
Requires-Dist: sqlmodel<0.0.25,>=0.0.24; extra == 'serve'
Requires-Dist: uvicorn<0.35.0,>=0.34.3; extra == 'serve'
Provides-Extra: traces
Requires-Dist: opentelemetry-api<2.0.0,>=1.33.0; extra == 'traces'
Requires-Dist: opentelemetry-exporter-otlp<2.0.0,>=1.33.0; extra == 'traces'
Requires-Dist: opentelemetry-instrumentation<0.55,>=0.54b0; extra == 'traces'
Requires-Dist: opentelemetry-sdk<2.0.0,>=1.33.0; extra == 'traces'
Description-Content-Type: text/markdown

<h1>
  <a href="https://github.com/dowhiledev/nomos">
    <img src="docs/assets/banner.jpg" alt="NOMOS">
  </a>
</h1>

<div>

![PyPI - Version](https://img.shields.io/pypi/v/nomos?style=flat-square)
[![npm version](https://img.shields.io/npm/v/nomos-sdk.svg?style=flat-square)](https://www.npmjs.com/package/nomos-sdk)
[![codecov](https://codecov.io/gh/dowhiledev/nomos/graph/badge.svg?token=MXRK9HGE5R&style=flat-square)](https://codecov.io/gh/dowhiledev/nomos)
[![Test](https://github.com/dowhiledev/nomos/actions/workflows/test.yml/badge.svg?style=flat-square)](https://github.com/dowhiledev/nomos/actions/workflows/test.yml)
[![Release](https://github.com/dowhiledev/nomos/actions/workflows/publish.yml/badge.svg?style=flat-square)](https://github.com/dowhiledev/nomos/actions/workflows/publish.yml)
[![Docker Image](https://img.shields.io/badge/ghcr.io-nomos-blue?style=flat-square)](https://github.com/dowhiledev/nomos/pkgs/container/nomos)
[![Open Issues](https://img.shields.io/github/issues-raw/dowhiledev/nomos?style=flat-square)](https://github.com/dowhiledev/nomos/issues)

</div>

> [!NOTE]
> Looking for client-side integration? Check out our [TypeScript/JavaScript SDK](support/ts-sdk/README.md).

**NOMOS** is a framework for building advanced LLM-powered assistants with structured, multi-step workflows. It helps you create sophisticated AI agents through configurable flows, tools, and integrations — making complex agent development accessible from no-code to full-code approaches.

```bash
pip install nomos[cli]
```

To learn more about NOMOS, check out [the documentation](docs/md/). If you're looking for quick prototyping, try our [Playground](https://nomos-builder.vercel.app/) for drag-and-drop agent creation.

<details>
<summary>Table of Contents</summary>

- [Why use NOMOS?](#why-use-nomos)
- [NOMOS Ecosystem](#nomos-ecosystem)
- [Key Features](#key-features)
- [Documentation](#documentation)
- [Additional Resources](#additional-resources)

**[Complete Documentation](docs/md/) | [Try Playground](https://nomos-builder.vercel.app/) | [Quick Start Guide](docs/md/getting-started.md)**

</details>

---

## Why use NOMOS?

NOMOS helps developers build sophisticated AI agents through structured workflows and configurable components, making complex agent development accessible to teams of all skill levels.

| Use Case | Description |
|----------|-------------|
| **Multi-step Workflows** | Complex, stateful interactions with specialized tools and intelligent routing |
| **Rapid Prototyping** | No-code Playground → YAML config → Full Python implementation |
| **Tool Integration** | Python functions, CrewAI, LangChain tools with auto-documentation |
| **Production Deployment** | Built-in session management, error handling, and monitoring |

## NOMOS Ecosystem

| Component | Description | Link |
|-----------|-------------|------|
| **Playground** | Drag-and-drop flow designer for rapid prototyping | [Try it live →](https://nomos-builder.vercel.app/) |
| **TypeScript SDK** | Full-featured client library for web and Node.js | [Documentation →](support/ts-sdk/README.md) |
| **Docker Images** | Pre-configured containers with Redis, PostgreSQL support (GitHub Packages + Docker Hub) | [Deployment Guide →](docs/md/deployment.md#docker-base-image) |
| **CLI Tools** | Complete toolkit: `init`, `run`, `serve`, `test`, `validate`, `schema` | [CLI Reference →](docs/md/cli-usage.md) |

## Key Features

| Category | Feature | Description |
|----------|---------|-------------|
| **Architecture** | Step-based Flows | Define agent behavior as sequences of steps with tools and transitions |
| | Advanced Flow Management | Organize steps into flows with shared context and components |
| | Flow Memory | Each flow maintains context with intelligent cross-flow summarization |
| **Development** | Multiple Config Options | Python API or declarative YAML configuration |
| | Playground | Drag-and-drop interface for designing flows **[Try it live →](https://nomos-builder.vercel.app/)** |
| | Interactive CLI | Bootstrap agents with `nomos init`, run with `nomos run` |
| **Tools & Integration** | Tool Integration | Register Python functions, packages, CrewAI, or LangChain tools |
| | Auto Documentation | Tool descriptions generated from docstrings |
| | External Packages | Reference any Python package function via configuration |
| **LLM Support** | Multiple Providers | OpenAI, Mistral, Gemini, Ollama, and HuggingFace |
| | Structured Responses | Step-level answer models for JSON/object responses |
| | Persona-driven | Consistent, branded agent responses |
| | Decision Examples | Retrieve relevant examples to guide step decisions |
| **Production Ready** | Session Management | Redis/PostgreSQL storage for conversation persistence |
| | Error Handling | Built-in recovery with configurable retry limits |
| | API Integration | FastAPI endpoints for web and WebSocket interaction |
| | Monitoring | Elastic APM tracing and distributed monitoring |
| | Docker Deployment | Pre-built base image for rapid deployment |
| **Extensibility** | Custom Components | Build your own tools, steps, and integrations |
| | Scalable Design | Horizontal scaling with stateless architecture |


## Documentation

For detailed information, check out our comprehensive guides:

| Guide | Description |
|-------|-------------|
| [Getting Started](docs/md/getting-started.md) | Installation, setup, and your first agent |
| [CLI Usage](docs/md/cli-usage.md) | Complete command-line interface guide |
| [Configuration](docs/md/configuration.md) | Python API and YAML configuration |
| [Flow Management](docs/md/flow-management.md) | Advanced workflow organization |
| [LLM Support](docs/md/llm-support.md) | Supported models and providers |
| [Examples](docs/md/examples.md) | Real-world implementation examples |
| [Deployment](docs/md/deployment.md) | Production deployment strategies |
| [Community](docs/md/community.md) | Contributing, support, and project information |

## Additional Resources

- **[Tutorials](docs/md/getting-started.md)**: Step-by-step guides for getting started with NOMOS, from installation to your first agent.
- **[How-to Guides](docs/md/)**: Quick, actionable code snippets for common tasks like tool integration, flow management, and deployment.
- **[Examples](docs/md/examples.md)**: Real-world implementations including a barista ordering system, financial advisor, and travel planner.
- **[API Reference](docs/md/configuration.md)**: Detailed documentation on Python API and YAML configuration options.
- **[CLI Reference](docs/md/cli-usage.md)**: Complete command-line interface documentation for development and deployment.

Join the NOMOS community! For roadmap, support, contributing guidelines, and more, see our [Community Guide](docs/md/community.md).
