Metadata-Version: 2.4
Name: nao-core
Version: 0.0.3
Summary: nao Core is your analytics context builder with the best chat interface.
Project-URL: Homepage, https://github.com/naolabs/chat
Project-URL: Repository, https://github.com/naolabs/chat
Author: nao Labs
License-Expression: MIT
License-File: LICENSE
Keywords: ai,analytics,chat
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: cyclopts>=4.4.4
Requires-Dist: pydantic>=2.10.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=14.0.0
Description-Content-Type: text/markdown

# nao CLI

Command-line interface for nao chat.

## Installation

```bash
pip install nao-core
```

## Usage

### Start the chat interface

```bash
nao chat
```

This will start the nao chat server and open the web interface in your browser at `http://localhost:5005`.

## Development

### Building the package

```bash
cd cli
python build.py
```

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

### Installing for development

```bash
cd cli
pip install -e .
```

### Publishing to PyPI

```bash
# 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
```
