Getting Started

​

Prerequisites

• Python 3.9 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.

​

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

​

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