Skip to main content
This section contains real-world examples demonstrating NOMOS capabilities across different use cases.

​
Available Examples

Barista Agent

Complete coffee shop ordering system with multi-step workflows and tool integration

Financial Planning Assistant

Production-ready financial advisor with budget planning and savings goals

General Bot

Versatile conversational agent for quick prototyping

Travel Planner

Travel planning assistant with itinerary management

Git Search Agent

Repository search and code analysis agent

Master Roshi Agent

Dragon Ball-themed training assistant with API tool integration

TypeScript SDK Example

Client-side integration using the TypeScript SDK

​
Barista Agent

A complete coffee shop ordering system demonstrating:
Order taking, customization, and confirmation processes
Menu management, cart operations, and order processing
Organized order processing with context preservation
Graceful handling of invalid orders and edge cases
To run: 
cd cookbook/examples/barista
export OPENAI_API_KEY=your-api-key-here
nomos run --config config.agent.yaml

​
Financial Planning Assistant

A production-ready financial advisor demonstrating:
Income/expense tracking and analysis
Goal setting and progress monitoring
Comprehensive financial assessment
Session storage for ongoing consultations
Docker containerization
To run: 
cd cookbook/examples/financial-advisor
export OPENAI_API_KEY=your-api-key-here
nomos run --config config.agent.yaml

​
General Bot

A versatile conversational agent showing:
Natural language interaction
Simple utility functions
Clean YAML structure
Minimal configuration for fast prototyping
To run: 
cd cookbook/examples/general-bot
export OPENAI_API_KEY=your-api-key-here
nomos run --config config.agent.yaml

​
Master Roshi Agent

A Dragon Ball-themed training assistant demonstrating:
REST API calls with URL parameters and query strings
Integration with Dragon Ball API for character information
Character-specific responses and training advice
Custom tool definitions with argument validation
Dynamic character information retrieval
To run: 
cd cookbook/examples/master-roshi
export OPENAI_API_KEY=your-api-key-here
nomos run --config config.agent.yaml

​
Running Examples

1

Clone the Repository

git clone https://github.com/dowhiledev/nomos.git
cd nomos
2

Install NOMOS

pip install nomos[cli,openai]
3

Set Environment Variables

export OPENAI_API_KEY=your-api-key-here
4

Navigate to Example

cd cookbook/examples/barista  # or any other example
5

Run the Agent

nomos run --config config.agent.yaml

​
Example Categories

  • Barista Agent: Coffee shop ordering system
  • Financial Advisor: Budget planning and financial advice
  • Travel Planner: Trip planning and itinerary management

​
Contributing Examples

Want to contribute your own example? We’d love to see what you build with NOMOS!

Example Guidelines

Learn how to contribute examples

Submit Example

Share your example with the community
All examples include comprehensive documentation, configuration files, and step-by-step instructions to help you understand and adapt them for your own use cases.