Nagient

🇺🇸 English | 🇷🇺 Русский

Docker-native agent platform with centralized updates, scripted installation, and tag-driven releases.

Nagient is designed for predictable installation and updates on Linux, macOS, and Windows.

Install Latest Stable

Linux and macOS

curl -fsSL https://ngnt-in.ruka.me/install.sh | bash

Windows (PowerShell)

irm https://ngnt-in.ruka.me/install.ps1 | iex

Docker image

docker pull docker.io/parampo/nagient:latest

The installer creates a local runtime in ~/.nagient and starts Nagient via Docker Compose.

After installation, use one short control command instead of long Docker Compose commands:

nagient help

Detailed documentation:

• English index: docs/README.md
• Russian index: docs/README.ru.md

Upgrade and Remove

Use the shortcut command:

nagient update

powershell -ExecutionPolicy Bypass -File "$HOME/.nagient/bin/nagient.ps1" update

Remove installation:

nagient remove

powershell -ExecutionPolicy Bypass -File "$HOME/.nagient/bin/nagient.ps1" remove

To remove all local runtime data, set NAGIENT_PURGE=true before running uninstall.

Quick Start

1. Run installer for your platform.
2. Run nagient setup.
3. Use nagient paths to inspect aliases such as @config, @secrets, @prompts, and @tools.
4. Use nagient chat for a direct CLI console session with the configured provider.
5. Run short commands:

nagient up
nagient status
nagient logs

Short Command Surface

• nagient up|down|restart
• nagient status|doctor|preflight|reconcile
• nagient logs [service]
• nagient update|remove

Full CLI Surface

• nagient init, nagient help, nagient paths, nagient plugins, nagient preflight, nagient reconcile, nagient serve
• nagient setup, nagient chat
• nagient transport list|test|scaffold
• nagient provider list|scaffold|models
• nagient auth status|login|complete|logout
• nagient tool list|scaffold|invoke
• nagient interaction list|submit, nagient approval list|respond
• nagient update check, nagient manifest render, nagient migrations plan
• nagient agent turn --request-file ...

Full command reference with flags is in docs/README.md.

Runtime Flow

flowchart LR
	A[Install script] --> B[~/.nagient]
	B --> C[docker compose up -d]
	C --> D[entrypoint]
	D --> E[nagient reconcile]
	E --> F[nagient serve]
	F --> G[state and logs]

Loading

Notes

• Architecture (EN): docs/architecture.md
• Architecture (RU): docs/architecture.ru.md
• License: LICENSE