CLI Usage
Complete guide to using the NOMOS CLI for developing and deploying agents
The NOMOS CLI provides powerful commands to bootstrap, develop, and deploy your agents.
Commands Overview
nomos init
Create a new agent project
nomos run
Run agent in development mode
nomos train
Interactively refine agent decisions
nomos serve
Deploy agent with Docker
nomos test
Run agent tests
nomos schema
Export JSON schema for your config
Quick Help
Initialize a New Agent
Create a new agent project interactively:
Options
| Option | Short | Description | Default |
|---|---|---|---|
--directory | -d | Project directory | ./my-nomos-agent |
--name | -n | Agent name | - |
--template | -t | Template to use | basic, conversational, workflow |
--generate | -g | Generate agent configuration using AI | - |
--usecase | -u | Use case description or path to text file | - |
--tools | - | Comma-separated list of available tools | - |
Examples
Development Mode
Run your agent in an interactive development mode.
Options
| Option | Short | Description | Default |
|---|---|---|---|
--config | -c | Path to agent configuration file | config.agent.yaml |
--tools | -t | Python files containing tool definitions (can be used multiple times) | - |
--verbose | -v | Enable verbose logging | False |
Training Mode
Run your agent in an interactive training mode to refine its decisions.
Options
| Option | Short | Description | Default |
|---|---|---|---|
--config | -c | Path to agent configuration file | config.agent.yaml |
--tools | -t | Python files containing tool definitions (can be used multiple times) | - |
Production Deployment
Serve your agent as a production-ready API.
Options
| Option | Short | Description | Default |
|---|---|---|---|
--config | -c | Path to agent configuration file | config.agent.yaml |
--tools | -t | Python files containing tool definitions (can be used multiple times) | - |
--port | -p | Port to bind the server | 8000 |
--workers | -w | Number of uvicorn workers | 1 |
Testing
Run tests for your agent.
Options
| Option | Short | Description | Default |
|---|---|---|---|
--config | -c | Path to YAML test configuration file | tests.agent.yaml |
--coverage | Generate coverage report | True | |
pytest_args | Arguments to pass to pytest | - |
Generate YAML Schema
Export the JSON schema for your agent configuration.
Options
| Option | Short | Description | Default |
|---|---|---|---|
--output | -o | Write JSON schema to file instead of stdout | - |