nolune

agent
Security Audit
Warn
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.

SUMMARY

AI companion with soul, memory, and autonomous inner life

README.md

Nolune

Nolune

Your AI, with a computer of its own.
A personal AI companion that lives on your machine and works across your computers.

Website  •  Download

Rust SvelteKit Tauri MIT License


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 skin

Nolune — a warm, golden presence
Minty skin

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.


Nolune

Built by Triangle Interactive LLC

Reviews (0)

No results found