nolune
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 10 GitHub stars
Code Warn
- network request — Outbound network request in client/src/lib/api/client.ts
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
AI companion with soul, memory, and autonomous inner life
Nolune
Your AI, with a computer of its own.
A personal AI companion that lives on your machine and works across your computers.
Nolune is an open-source, self-hosted AI companion with a persistent identity, long-term memory, and the ability to use real computers.
Run Nolune's always-on brain on a Mac mini, home server, or spare computer. Then connect the desktop app on your other machines so Nolune can work with their screens, apps, files, and terminals from one interface.
Unlike a faceless agent dashboard, Nolune has a voice, personality, mood, and animated presence you can make your own. Your companion and its memories stay on hardware you control.
How it works
1. Give Nolune a home
Install the Nolune server on an always-on macOS or Linux machine. It keeps your companion running, stores its memory, and coordinates its work.
curl -fsSL https://nolune.dev/install.sh | bash
Open http://localhost:26559 and follow the onboarding.
2. Connect your computers
Install the desktop app on the computers where you want Nolune to act. Each connected machine becomes another place where your companion can see the screen, use apps, work with files, and run commands.
For example, Nolune can live on a Mac mini at home while you talk to it through the desktop app on your MacBook.
3. Ask it to do the work
Talk to Nolune normally. It can research something on the web, organize files, work inside an app, run a command on a connected machine, or continue a task while you are away.
Computer-use actions appear through a visible desktop overlay. You choose which machines to connect and grant the operating-system permissions they need.
Why Nolune
A companion, not a control panel
Nolune is designed around one persistent character rather than a collection of disposable chats. Its personality lives in soul.md, its mood changes over time, and its animated skin gives it a recognizable presence.
One mind across multiple computers
The server holds Nolune's identity and memory. Connected desktop apps give it eyes and hands on other machines. You can keep the server somewhere reliable and interact with the same companion from wherever you work.
Memory you can inspect
Nolune stores memories as ordinary files organized by topic. You can read them, edit them, back them up, or remove them. Keyword and semantic retrieval bring relevant memories back into later conversations.
Proactive when you want it to be
Heartbeats and schedules let Nolune check in, follow recurring routines, and start useful work without waiting for a new message every time.
Yours from end to end
Nolune is self-hosted and BYOK. There is no required Nolune cloud account, and Nolune does not impose its own usage limits. Your model provider's pricing and limits still apply.
Companion skins
Nolune — a warm, golden presence |
Minty — a friendly, animated character |
Skins change how your companion looks and feels without replacing its memory or identity. More customization is planned.
Capabilities
- Computer use — See the screen, click, type, scroll, and use apps on connected machines.
- Remote files and shell — Read and edit files or run commands on the server and connected computers.
- Persistent memory — Remember people, preferences, projects, and shared moments across conversations.
- Voice — Speak through optional text-to-speech and voice mode.
- Web and communication — Search the web, work with email, and use installed integrations.
- Skills and MCP — Add new workflows and connect external tools without changing Nolune's core.
- Schedules and heartbeats — Run recurring routines and initiate conversations proactively.
Install
Server
The one-line installer sets up the native Nolune server and service on macOS or Linux:
curl -fsSL https://nolune.dev/install.sh | bash
When installation finishes, open http://localhost:26559 and complete onboarding.
Desktop app
Download the desktop app from GitHub Releases. Builds are available for macOS, Windows, and Linux.
Connect it to your self-hosted Nolune server to use the companion interface and enable computer use on that machine.
The release workflow runs on v* tags; manual runs must select a v* tag. It publishes server binaries and macOS, Windows, and Linux desktop artifacts. Nothing in this workflow provisions or updates running servers.
Architecture
server/ Rust + Axum — always-on brain, tools, memory, and embedded web client
client/ SvelteKit 5 — companion interface
desktop/ Tauri 2 — native client and computer-use bridge
landing/ SvelteKit — public website and documentation
| Layer | Technology |
|---|---|
| Server | Rust, Axum, Tokio |
| LLM | Anthropic or OpenAI API |
| Web client | SvelteKit 5, Tailwind CSS |
| Desktop | Tauri 2 |
| Memory | File-based storage with keyword and vector search |
| Extensions | Skills and Model Context Protocol |
| Distribution | Native binaries, launchd, and systemd |
Data layout
Everything important is stored as files under ~/.nolune:
~/.nolune/
├── config.toml
└── instances/
└── {slug}/
├── soul.md personality definition
├── heartbeat.md proactive behavior
├── mood.json emotional state
├── memory/ long-term memory library
├── drops/ autonomous creative artifacts
├── uploads/ user-uploaded files
├── skills/ installed skills
└── chats/ conversation history
Configuration
Most settings are available through the interface. Advanced configuration lives at ~/.nolune/config.toml.
| Environment variable | Description |
|---|---|
NOLUNE_HOME |
Data directory, defaults to ~/.nolune |
NOLUNE_AUTH_TOKEN |
Authentication token override |
NOLUNE_PUBLIC_URL |
Public URL for the server |
ANTHROPIC_API_KEY |
Anthropic API key override |
OPENAI_API_KEY |
OpenAI API key override |
RUST_LOG |
Logging level, defaults to info |
Updates
For one-line installations, Nolune checks for updates automatically. Apply an update through Settings or run:
~/.nolune/bin/update
Uninstall
curl -fsSL https://nolune.dev/uninstall.sh | bash
Keep your data while removing the server:
KEEP_DATA=1 curl -fsSL https://nolune.dev/uninstall.sh | bash
Development
See the Nolune launch cutover checklist for repository, domain, and release setup.
# Server
cd server && cargo run
# Web client
cd client && pnpm install && pnpm dev
# Desktop app
cd desktop && pnpm install && pnpm tauri dev
# Landing site
cd landing && pnpm install && pnpm dev
Use pnpm, not npm, for the JavaScript workspaces. See CONTRIBUTING.md for the complete development setup.
Security
Computer use and remote access are powerful capabilities. Only connect machines you control, keep your authentication token private, and review the permissions granted to the desktop app.
See SECURITY.md to report a vulnerability.
License
MIT — see LICENSE.
Built by Triangle Interactive LLC
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found