nao-core 0.0.28

nao Core is your analytics context builder with the best chat interface.

nao CLI

Command-line interface for nao chat.

Installation

pip install nao-core

Usage

nao --help
Usage: nao COMMAND

╭─ Commands ────────────────────────────────────────────────────────────────╮
│ chat         Start the nao chat UI.                                       │
│ init         Initialize a new nao project.                                │
│ --help (-h)  Display this message and exit.                               │
│ --version    Display application version.                                 │
╰───────────────────────────────────────────────────────────────────────────╯

Initialize a new nao project

nao init

This will create a new nao project in the current directory. It will prompt you for a project name and ask you if you want to set up an LLM configuration.

Start the nao chat UI

nao chat

This will start the nao chat UI. It will open the chat interface in your browser at http://localhost:5005.

Development

Building the package

cd cli
python build.py --help
Usage: build.py [OPTIONS]

Build and package nao-core CLI.

╭─ Commands ────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help (-h)  Display this message and exit.                                                               │
│ --version    Display application version.                                                                 │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Parameters ──────────────────────────────────────────────────────────────────────────────────────────────╮
│ --force -f --no-force              Force rebuild the server binary [default: False]                       │
│ --skip-server -s --no-skip-server  Skip server build, only build Python package [default: False]          │
│ --bump                             Bump version before building (patch, minor, major) [choices: patch,    │
│                                    minor, major]                                                          │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────╯

This will:

1. Build the frontend with Vite
2. Compile the backend with Bun into a standalone binary
3. Bundle everything into a Python wheel in dist/

Options:

• --force / -f: Force rebuild the server binary
• --skip-server: Skip server build, only build Python package
• --bump: Bump version before building (patch, minor, major)

Installing for development

cd cli
pip install -e .

Publishing to PyPI

# Build first
python build.py

# Publish
uv publish dist/*

Architecture

nao chat (CLI command)
    ↓ spawns
nao-chat-server (Bun-compiled binary)
    ↓ serves
Backend API + Frontend Static Files
    ↓
Browser at http://localhost:5005