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

Available Examples

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

  • Business Applications
  • Developer Tools
  • Integration Patterns
  • 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!
All examples include comprehensive documentation, configuration files, and step-by-step instructions to help you understand and adapt them for your own use cases.
I