Metadata-Version: 2.4
Name: navi-agent
Version: 0.1.1
Summary: A self-improving agent inspired by Hermes Agent.
Project-URL: Documentation, https://www.agent-io.com/navi-agent/
Project-URL: Issues, https://github.com/xushun007/navi-agent/issues
Project-URL: Repository, https://github.com/xushun007/navi-agent
Author: xushun007
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: ddgs>=9.14.4
Requires-Dist: langfuse>=2.60.8
Requires-Dist: openai>=2.45.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pyyaml>=6.0.0
Provides-Extra: eval
Requires-Dist: inspect-ai>=0.3.249; extra == 'eval'
Provides-Extra: swe-bench
Requires-Dist: inspect-ai>=0.3.249; extra == 'swe-bench'
Requires-Dist: inspect-evals[swe-bench]>=0.16.0; extra == 'swe-bench'
Description-Content-Type: text/markdown

# Navi Agent

English | [简体中文](README.zh-CN.md)

Navi Agent is a compact, self-evolving agent runtime inspired by Hermes. It focuses on a
single reliable execution pipeline across runtime, tools, memory, telemetry, and evolution,
with WeChat as the first gateway.

## Documentation

**[Run Navi Agent in 2 minutes](https://www.agent-io.com/navi-agent/getting-started/)**

Configuration, tools, permissions, sessions, memory, architecture, and the Weixin gateway.

## Quickstart

```bash
uv tool install git+https://github.com/xushun007/navi-agent.git
navi-agent init
# Add your model credentials to ~/.navi-agent/config.yaml
navi-agent doctor
navi-agent
```

Start the WeChat gateway:

```bash
navi-agent doctor --doctor-gateway weixin
navi-agent gateway start
```

Navi Agent stores config and runtime data under `~/.navi-agent`. Use
`NAVI_PROFILE=work` for an isolated profile or `NAVI_HOME=/custom/path` for a
custom location.

Allow access to additional directories explicitly:

```bash
navi-agent --add-dir ../shared --add-dir /path/to/repo
```

## WeChat

Configure `~/.navi-agent/config.yaml`:

```yaml
gateway:
  weixin:
    token: your-token
    account_id: your-account-id
    base_url: https://ilinkai.weixin.qq.com
    dm_policy: pairing
    allowed_users: []
```

`dm_policy` supports `open`, `pairing`, `allowlist`, and `disabled`. Manage
pairing requests with:

```bash
navi-agent --gateway-pairings weixin
navi-agent --approve-gateway-pairing 123456
```

## Evaluation

Inspect evaluations use the production Navi runtime and write replayable results
under `~/.navi-agent/evals/inspect/`.

```bash
uv sync --extra eval
uv run navi-agent eval run general-qa
uv run navi-agent eval run human-eval
uv run navi-agent eval run bfcl
uv run navi-agent eval run agentbench-os
uv run navi-agent eval run swe-bench-verified --limit 1
```

See [evals/README.md](evals/README.md) for suites and usage.

## Development

```bash
uv sync
uv run pytest
uv run navi-agent
```
