Skip to content

Repository files navigation

Nexus Logo

The Core of Your AGI.
A high-performance desktop agent — Rust · Tauri · React

ArchitectureBrand IdentityQuick StartBuilding

Rust Tauri React MIT Build Status


Nexus — a desktop agent born from the hermes-agent-rs engine. Rust-native performance. Tauri shell. Self-evolving AGI core.

✦ Brand Identity

N E X U S — The name is the logo. The X is formed by two intersecting triangles, the central point where all intelligence converges:

N  E  ⧉  U  S
   The Core of Your AGI

The X-core uses:

  • Cyan triangle #00d4ff — active intelligence, data flow
  • Magenta triangle #ff00e4 — creative reasoning, exploration
  • White core dot — the AGI nexus point, pulsing with energy

The wordmark is built with JetBrains Mono — geometric, sharp, monospaced. Every letter is a structural element.

✦ Architecture

┌──────────────────────────────────────────┐
│             Nexus Desktop App            │
├──────────────┬───────────────────────────┤
│  Frontend    │  Backend (Rust + Tauri)   │
│  React 19    │                           │
│  Vite 6      │  Agent Engine             │
│  TS 5.6      │  Provider Router          │
│              │  Skill Manager            │
│  Dark UI     │  Session Store            │
│  Chat +      │  Config System            │
│  Config      │  Gateway Manager          │
├──────────────┴───────────────────────────┤
│  hermes-agent-rs (Lumio Research)        │
│  AgentLoop · LlmProvider · ToolHandler   │
│  PlatformAdapter · Memory · Cron · MCP   │
├──────────────────────────────────────────┤
│  Windows · macOS · Linux                 │
└──────────────────────────────────────────┘

10 LLM providers · 30+ tool backends · 17 platform gateways · 8 memory backends

✦ Quick Start

# Prerequisites
# ─ Windows: Visual Studio Build Tools (msvc linker)
# ─ macOS:   brew install webkit2gtk
# ─ Linux:   sudo apt install libwebkit2gtk-4.1-dev

git clone https://github.com/junagent/nexus.git
cd nexus
npm install
npm run tauri dev

✦ Building

# Development (hot-reload frontend + backend)
npm run tauri dev

# Production installer
npm run tauri build

Output installers:

  • Windows: src-tauri/target/release/bundle/msi/Nexus_*.msi
  • macOS: src-tauri/target/release/bundle/dmg/Nexus_*.dmg
  • Linux: src-tauri/target/release/bundle/deb/nexus_*.deb

GitHub Actions builds all three platforms automatically on every push. Download the latest release from the Releases page.

✦ Configuration

Config directory: ~/.nexus/ (Linux/macOS) or %APPDATA%/nexus/ (Windows)

Set API keys in ~/.nexus/.env:

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
OPENROUTER_API_KEY=sk-...

✦ Credits

✦ License

MIT — see LICENSE


Built with Rust · Tauri · ❤️

About

Nexus — The Core of Your AGI. A desktop agent built on hermes-agent-rs with a Rust + Tauri + React stack.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages