Contributing

Nurvus is written in Python 3.10+ and uses uv for dependency management. The codebase prioritizes readability and simplicity. PRs welcome.

Setup

git clone https://codeberg.org/ewrogers/nurvus.git
cd nurvus
uv sync
uv run demi

Commits

All commits follow Conventional Commits.

Architecture

TUI (Textual) -> Agent Core -> Ollama (local LLM)
                    |
              Tool Engine -> NixOS config reader/writer
                          -> Container management (Podman)
                          -> System inspection
                          -> Network diagnostics
                          -> File management (/srv/)
                          -> Docker Hub registry lookup

The agent operates through tools, which are structured functions it can call to inspect and modify the system. All system-changing tools require confirmation before executing. NixOS's generation system means any change can be rolled back instantly.

License

MIT