Metadata-Version: 2.4
Name: nanometry
Version: 0.1.0
Summary: Open-source monitoring dashboard for Nanobot AI agents
Project-URL: Homepage, https://nanometry.dev
Project-URL: Repository, https://github.com/vivekchand/nanometry
Project-URL: Issues, https://github.com/vivekchand/nanometry/issues
Author: Vivek
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agent,dashboard,monitoring,nanobot,observability
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: flask>=3.0
Description-Content-Type: text/markdown

# 🔬 Nanometry

**Open-source monitoring dashboard for [Nanobot](https://github.com/HKUDS/nanobot) AI agents.**

Nanometry gives you a real-time web dashboard to monitor your Nanobot instance — sessions, memory, cron jobs, token usage, and system health — all without modifying Nanobot itself.

![Dashboard Screenshot](docs/screenshot-placeholder.png)

## Features

- 📊 **Overview Dashboard** — Sessions, messages, channels, providers, tool usage at a glance
- 💬 **Session Viewer** — Browse conversation history across all channels
- 🧠 **Memory Inspector** — View MEMORY.md (long-term) and HISTORY.md (searchable log)
- ⏰ **Cron Jobs Monitor** — See scheduled tasks, their status, and next run times
- ⚙️ **Config Viewer** — Parsed config.json with secrets automatically redacted
- 🖥️ **System Health** — Workspace stats, storage usage, environment info
- 🌑 **Dark Theme** — Clean, modern UI

## Installation

```bash
pip install nanometry
```

## Quick Start

```bash
# Start the dashboard (reads from ~/.nanobot by default)
nanometry

# Custom nanobot directory
nanometry --nanobot-dir /path/to/.nanobot

# Custom host/port
nanometry --host 0.0.0.0 --port 8080
```

Then open **http://localhost:9820** in your browser.

## How It Works

Nanometry is **read-only** — it never modifies your Nanobot data. It reads:

| Data | Location | What it shows |
|------|----------|---------------|
| Config | `~/.nanobot/config.json` | Channels, providers, agent settings |
| Sessions | `~/.nanobot/sessions/*.jsonl` | Conversation history, tool usage |
| Memory | `workspace/memory/MEMORY.md` | Long-term agent memory |
| History | `workspace/memory/HISTORY.md` | Consolidated conversation history |
| Cron | `~/.nanobot/cron.json` | Scheduled jobs and their state |

## Requirements

- Python 3.10+
- A running (or previously run) Nanobot instance
- Flask (installed automatically)

## Development

```bash
git clone https://github.com/niceparadox/nanometry.git
cd nanometry
pip install -e .
nanometry --debug
```

## License

MIT — see [LICENSE](LICENSE).

---

Built with 🐈 for the Nanobot community.
