{"id":29647578,"url":"https://github.com/dowhiledev/nomos","last_synced_at":"2026-04-01T21:02:52.524Z","repository":{"id":290072831,"uuid":"972857880","full_name":"dowhiledev/nomos","owner":"dowhiledev","description":"Ship agents you can audit.","archived":false,"fork":false,"pushed_at":"2025-11-09T15:53:40.000Z","size":5473,"stargazers_count":88,"open_issues_count":16,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-28T00:36:32.930Z","etag":null,"topics":["agent","agent-testing","agentic-ai","flow-based-agent","step-guided-agent"],"latest_commit_sha":null,"homepage":"https://nomos.dowhile.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dowhiledev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support/playground/README.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-04-25T19:31:54.000Z","updated_at":"2026-03-15T15:38:30.000Z","dependencies_parsed_at":"2025-05-07T17:45:51.456Z","dependency_job_id":"860d112c-ef6d-4426-bce8-4c32ff09755d","html_url":"https://github.com/dowhiledev/nomos","commit_stats":null,"previous_names":["chandralegend/sofia","sofia-hq/sofia","dowhiledev/sofia","dowhiledev/nomos"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/dowhiledev/nomos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fnomos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fnomos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fnomos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fnomos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dowhiledev","download_url":"https://codeload.github.com/dowhiledev/nomos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fnomos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agent-testing","agentic-ai","flow-based-agent","step-guided-agent"],"created_at":"2025-07-22T03:38:03.775Z","updated_at":"2026-04-01T21:02:52.509Z","avatar_url":"https://github.com/dowhiledev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://github.com/dowhiledev/nomos\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/dark.png\"\u003e\n      \u003cimg src=\"docs/assets/light.png\" alt=\"NOMOS\" height=\"250\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/h1\u003e\n\n\n\u003cdiv\u003e\n\n![PyPI - Version](https://img.shields.io/pypi/v/nomos?style=flat-square)\n[![npm version](https://img.shields.io/npm/v/nomos-sdk.svg?style=flat-square)](https://www.npmjs.com/package/nomos-sdk)\n[![codecov](https://codecov.io/gh/dowhiledev/nomos/graph/badge.svg?token=MXRK9HGE5R\u0026style=flat-square)](https://codecov.io/gh/dowhiledev/nomos)\n[![Test](https://github.com/dowhiledev/nomos/actions/workflows/test.yml/badge.svg?style=flat-square)](https://github.com/dowhiledev/nomos/actions/workflows/test.yml)\n[![Release](https://github.com/dowhiledev/nomos/actions/workflows/publish.yml/badge.svg?style=flat-square)](https://github.com/dowhiledev/nomos/actions/workflows/publish.yml)\n[![Docker Image](https://img.shields.io/badge/ghcr.io-nomos-blue?style=flat-square)](https://github.com/dowhiledev/nomos/pkgs/container/nomos)\n[![Open Issues](https://img.shields.io/github/issues-raw/dowhiledev/nomos?style=flat-square)](https://github.com/dowhiledev/nomos/issues)\n\n\u003c/div\u003e\n\n\u003e [!NOTE]\n\u003e Looking for client-side integration? Check out our [TypeScript/JavaScript SDK](support/ts-sdk/README.md).\n\n**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.\n\n```bash\npip install nomos[cli]\n```\n\nTo 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.\n\n\u003cdetails\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [Why use NOMOS?](#why-use-nomos)\n- [NOMOS Ecosystem](#nomos-ecosystem)\n- [Key Features](#key-features)\n- [Documentation](#documentation)\n- [Additional Resources](#additional-resources)\n\n**[Complete Documentation](docs/md/) | [Try Playground](https://nomos-builder.vercel.app/) | [Quick Start Guide](docs/md/getting-started.md)**\n\n\u003c/details\u003e\n\n---\n\n## Why use NOMOS?\n\nNOMOS helps developers build sophisticated AI agents through structured workflows and configurable components, making complex agent development accessible to teams of all skill levels.\n\n| Use Case | Description |\n|----------|-------------|\n| **Multi-step Workflows** | Complex, stateful interactions with specialized tools and intelligent routing |\n| **Structured Data** | Define reusable schemas for consistent, validated responses across agents |\n| **Rapid Prototyping** | No-code Playground → YAML config → Full Python implementation |\n| **Tool Integration** | Python functions, CrewAI, LangChain tools, External APIs with auto-documentation |\n| **Production Deployment** | Built-in session management, error handling, and monitoring |\n\n## NOMOS Ecosystem\n\n| Component | Description | Link |\n|-----------|-------------|------|\n| **Playground** | Drag-and-drop flow designer for rapid prototyping | [Try it live →](https://nomos-builder.vercel.app/) |\n| **TypeScript SDK** | Full-featured client library for web and Node.js | [Documentation →](support/ts-sdk/README.md) |\n| **Docker Images** | Pre-configured containers with Redis, PostgreSQL support (GitHub Packages) | [Deployment Guide →](docs/md/deployment.md#docker-base-image) |\n| **CLI Tools** | Complete toolkit: `init`, `run`, `serve`, `test`, `validate`, `schema` | [CLI Reference →](docs/md/cli-usage.md) |\n\n## Key Features\n\n| Category | Feature | Description |\n|----------|---------|-------------|\n| **Architecture** | Step-based Flows | Define agent behavior as sequences of steps with tools and transitions |\n| | Advanced Flow Management | Organize steps into flows with shared context and components |\n| | Flow Memory | Each flow maintains context with intelligent cross-flow summarization |\n| **Development** | Multiple Config Options | Python API or declarative YAML configuration |\n| | Playground | Drag-and-drop interface for designing flows **[Try it live →](https://nomos-builder.vercel.app/)** |\n| | Interactive CLI | Bootstrap agents with `nomos init`, run with `nomos run` |\n| **Tools \u0026 Integration** | Tool Integration | Register Python functions, packages, CrewAI, External APIs or LangChain tools |\n| | Auto Documentation | Tool descriptions generated from docstrings |\n| | External Packages | Reference any Python package function via configuration |\n| | External API Tools | Use any REST API with ease (No wrapping needed.) |\n| **LLM Support** | Multiple Providers | OpenAI, Mistral, Gemini, Ollama, and HuggingFace |\n| | Structured Responses | Step-level answer models for JSON/object responses |\n| | External Schemas | Define reusable schemas in JSON or Python files |\n| | Persona-driven | Consistent, branded agent responses |\n| | Decision Examples | Retrieve relevant examples to guide step decisions |\n| **Production Ready** | Session Management | Redis/PostgreSQL storage for conversation persistence |\n| | Error Handling | Built-in recovery with configurable retry limits |\n| | API Integration | FastAPI endpoints for web and WebSocket interaction |\n| | Monitoring | Elastic APM tracing and distributed monitoring |\n| | Docker Deployment | Pre-built base image for rapid deployment |\n| **Extensibility** | Custom Components | Build your own tools, steps, and integrations |\n| | Scalable Design | Horizontal scaling with stateless architecture |\n\n\n## Documentation\n\nFor detailed information, check out our comprehensive guides:\n\n| Guide | Description |\n|-------|-------------|\n| [Getting Started](docs/md/getting-started.md) | Installation, setup, and your first agent |\n| [CLI Usage](docs/md/cli-usage.md) | Complete command-line interface guide |\n| [Configuration](docs/md/configuration.md) | Python API and YAML configuration |\n| [Flow Management](docs/md/flow-management.md) | Advanced workflow organization |\n| [LLM Support](docs/md/llm-support.md) | Supported models and providers |\n| [Examples](docs/md/examples.md) | Real-world implementation examples |\n| [Deployment](docs/md/deployment.md) | Production deployment strategies |\n| [Community](docs/md/community.md) | Contributing, support, and project information |\n\n## Additional Resources\n\n- **[Tutorials](docs/md/getting-started.md)**: Step-by-step guides for getting started with NOMOS, from installation to your first agent.\n- **[How-to Guides](docs/md/)**: Quick, actionable code snippets for common tasks like tool integration, flow management, and deployment.\n- **[Examples](docs/md/examples.md)**: Real-world implementations including a barista ordering system, financial advisor, and travel planner.\n- **[API Reference](docs/md/configuration.md)**: Detailed documentation on Python API and YAML configuration options.\n- **[CLI Reference](docs/md/cli-usage.md)**: Complete command-line interface documentation for development and deployment.\n\nJoin the NOMOS community! For roadmap, support, contributing guidelines, and more, see our [Community Guide](docs/md/community.md).\n\n[![Discord Banner 2](https://discord.com/api/guilds/1393886830553731183/widget.png?style=banner2)](https://discord.com/invite/KEWVDFrvKS?utm_source=Discord%20Widget\u0026utm_medium=Connect)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdowhiledev%2Fnomos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdowhiledev%2Fnomos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdowhiledev%2Fnomos/lists"}