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.
pip install nomos[cli]
To learn more about NOMOS, check out the documentation. If you're looking for quick prototyping, try our Playground for drag-and-drop agent creation.
Table of Contents
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, External APIs 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 → |
| TypeScript SDK | Full-featured client library for web and Node.js | Documentation → |
| Docker Images | Pre-configured containers with Redis, PostgreSQL support (GitHub Packages) | Deployment Guide → |
| CLI Tools | Complete toolkit: init, run, serve, test, validate, schema |
CLI Reference → |
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 → | |
| Interactive CLI | Bootstrap agents with nomos init, run with nomos run |
|
| Tools & Integration | Tool Integration | Register Python functions, packages, CrewAI, External APIs or LangChain tools |
| Auto Documentation | Tool descriptions generated from docstrings | |
| External Packages | Reference any Python package function via configuration | |
| External API Tools | Use any REST API with ease (No wrapping needed.) | |
| 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 | Installation, setup, and your first agent |
| CLI Usage | Complete command-line interface guide |
| Configuration | Python API and YAML configuration |
| Flow Management | Advanced workflow organization |
| LLM Support | Supported models and providers |
| Examples | Real-world implementation examples |
| Deployment | Production deployment strategies |
| Community | Contributing, support, and project information |
Additional Resources
- Tutorials: Step-by-step guides for getting started with NOMOS, from installation to your first agent.
- How-to Guides: Quick, actionable code snippets for common tasks like tool integration, flow management, and deployment.
- Examples: Real-world implementations including a barista ordering system, financial advisor, and travel planner.
- API Reference: Detailed documentation on Python API and YAML configuration options.
- CLI Reference: Complete command-line interface documentation for development and deployment.
Join the NOMOS community! For roadmap, support, contributing guidelines, and more, see our Community Guide.
1 maintainer
Metadata
1 maintainer
Release files for nomos 0.3.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nomos-0.3.7.tar.gz | 1.5 MB | With provenance | Details for nomos-0.3.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nomos-0.3.7-py3-none-any.whl | Python 3 | none | any | Details for nomos-0.3.7-py3-none-any.whl |
Total release size: 1.6 MB
Release files / nomos-0.3.7.tar.gz
| Download URL | nomos-0.3.7.tar.gz |
|---|---|
| Size | 1.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5ce4a8d676c5977757321475032b2d78052e95ccc1eb0e05363e03fca550bbd5
|
|
BLAKE2b-256 checksum How to use checksums |
77c64ee801747c95ce11fae554d32359c2cf41b228cc9ba828a97dcfb572611b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 20, 2025.
Transparency logRelease files / nomos-0.3.7-py3-none-any.whl
| Download URL | nomos-0.3.7-py3-none-any.whl |
|---|---|
| Size | 109.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1369193c18db10d4eae927e4ab63a8dd19e386b1a10df17f790193774e9ccc39
|
|
BLAKE2b-256 checksum How to use checksums |
8c41b46ddb185b064b928a3a481e7fe082118a536b4a0c23910664293a546aec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 20, 2025.
Transparency logSecurity for nomos 0.3.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nomos-0.3.7.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 20, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
