Skip to main content

​
Step 1: Install nao-core package

pip install nao-core

​
Step 2: Initialize a nao project

nao init
This command will ask you:
  • To name your project
  • If you want to connect a database (optional)
  • If you want to add a repo in agent context (optional)
  • To add an LLM key (optional)
  • If you want to setup a Slack connection (optional)
You can skip any optional question and configure them later in your nao_config.yaml file.
This will create:
  • A new folder with your project name
  • An architecture for your context files
  • A nao_config.yaml configuration file
  • A RULES.md file

​
Step 3: Verify your setup

cd to the project folder and run: 
nao debug
This command checks your configuration and displays any issues.

​
Step 4: Synchronize your context

nao sync
This will populate your context folder with your context files (data, metadata, repos, etc.).

​
Step 5: Launch the chat and ask questions

nao chat
This will start the nao chat UI. It will open the chat interface in your browser at http://localhost:5005. From there, you can start asking questions to your agent!

​
Docker

Pull the image from DockerHub: 
docker pull getnao/nao:latest
Run with Docker: 
docker run -d \
  --name nao \
  -p 5005:5005 \
  -e NAO_DEFAULT_PROJECT_PATH=/app/example \
  -e OPENAI_API_KEY=sk-... \
  getnao/nao:latest
Access the UI at http://localhost:5005

Docker Deployment Guide

See the full Docker deployment guide for more options

​
What’s Next?

Context Builder

Learn how to build and customize your agent’s context

Self-Hosting

Deploy your agent in production

Chat Interface

Explore the chat interface features

nao Cloud

Use our managed cloud service