​
Prerequisites

  • Python 3.10 or higher
  • Optional: Redis or PostgreSQL for session storage
  • Optional: Elastic APM for tracing

​
Installation

​
From PyPI

pip install nomos

​
With CLI support

pip install nomos[cli]

​
With LLM support

pip install nomos[openai]

​
With server support

pip install nomos[serve]       # For FastAPI server support

​
With tracing support

pip install nomos[traces]      # For OpenTelemetry tracing

​
TypeScript/JavaScript SDK

For client-side applications and web development, use our npm package: 
npm install nomos-sdk
The TypeScript SDK provides full type safety and works in both Node.js and browser environments.

SDK Documentation

Complete SDK documentation and examples

​
Quick Example

import { NomosClient } from 'nomos-sdk';

const client = new NomosClient('http://localhost:8000');
const session = await client.createSession(true);
const response = await client.sendMessage(session.session_id, 'Hello!');

​
Quick Start

NOMOS supports a spectrum of implementation approaches from no-code to low-code to full-code development.

​
No-Code: Playground

Try Playground

The easiest way to get started - drag and drop to create your agent flows, then export the configuration.

​
Initialize Your First Agent

Create a new agent project interactively: 
nomos init
This will guide you through creating your first agent configuration.

​
Run Your Agent

nomos run
This starts your agent in development mode with hot reloading.

​
Next Steps

CLI Usage Guide

Detailed command documentation

Flow Management

Organizing complex workflows

Examples

See NOMOS in action

Configuration Guide

Advanced setup options