Selene

Selene is a desktop app that runs AI agents on your machine. Connect them to your WhatsApp, Telegram, Slack, or Discord. Write code, generate images, build personal assistants. All from one place. Your data stays on your device.

Every part of Selene (chat, embeddings, voice, images) lets you choose between local and cloud. Run everything offline or use APIs. Mix and match.

_{Integrates with}

Agent-First, Not Button-First

Every UI action is also an agent action — step in anywhere or let it run end-to-end. 99% of this codebase was written by Selene agents. How Selene came to exist in the first place is left as an exercise for the reader.

Why We Built It

AI is expensive because models re-read everything, every turn. Selene runs a small retrieval pipeline first — it finds what's relevant, the main agent picks it up and moves on. Tools load on demand. Context stays lean. You pay less per turn.

Modes

Selene Dev

Git, diffs, and PRs. Stage, branch, diff, PR — from the UI or via agent.
Built-in browser. Agent-controlled Chromium with console log access and session replay.
Output protection. Bundled Rust tool trims long build/test output before it hits the model.
Automatic checks. Hooks run type-checking, linting, or any custom logic after agent edits.

Selene Fun

3D avatar. Animated face with lip-sync and emotion detection.
Voice cloning. Custom voice via ElevenLabs or Microsoft.
Scheduled assistants. Cron tasks delivered to any connected channel.
Memory. Selene surfaces things to remember; you approve what sticks.

Selene Work (coming soon)

Team agents for company workflows.

Channels

Connect your agent to your apps. Not through webhooks, as a native integration.

Channel	Setup	What works
WhatsApp	Scan a QR code	Messages, voice notes, attachments
Telegram	Paste a bot token	Messages, voice bubbles, interactive buttons
Slack	Socket Mode	Messages, files, native UI elements, threads
Discord	Paste a bot token	Messages, threads, buttons, attachments

Voice notes are transcribed automatically. Pair with the scheduler for cron-based delivery.

Features


Voice & Avatar	STT (cloud/local, 32 languages), TTS with voice cloning, 3D avatar with lip-sync
Images	Local or cloud generation, reference images, ComfyUI workflows as agent tools
Video	Images → MP4 with transitions and overlays
Deep Research	Multi-pass web search with cited writeups
Memory	Surfaces suggestions after conversations; you approve what sticks
Scheduler	Cron, interval, or one-time tasks — delivered to any channel or kept in chat
Skills	Reusable agent instructions. 37+ built-in, create your own from the UI
Plugins	Bundle skills and tools together. Install from GitHub or a URL
MCP	Connect external services as agent tools
Hooks	Run custom logic before or after any agent action
Themes	8 color themes, light/dark, 50 wallpapers (20 live), rich text prompt editor

Providers

Use any combination, or go fully local with no API keys.

Provider	Models
Anthropic	Claude with Agent SDK
OpenAI	GPT-5.4, Codex
OpenRouter	Claude, Gemini, Grok, DeepSeek, and more
Ollama	Any local model
vLLM	Self-hosted inference
Kimi / Moonshot	256K context, vision
Minimax	3 variants
Antigravity	Free tier via Google OAuth

Download

macOS. Signed DMG, drag to Applications.
Windows. Signed installer or portable build.

One download, no prerequisites. Selene bundles everything: runtime, local model support, browser engine, platform tools. The app is larger than usual because it ships what other tools make you install separately.

For Developers

Setup

npm install
npm run electron:dev

Build

# Windows
npm run electron:dist:win

# macOS
npm run electron:dist:mac

Runtime Secrets

Set in .env:

INTERNAL_API_SECRET: internal API auth

Troubleshooting

Native module errors: npm run electron:rebuild-native
Embeddings mismatch: reindex from Settings
MCP ENOENT: reinstall from latest DMG/installer

Docs

docs/ARCHITECTURE.md: system layout
docs/AI_PIPELINES.md: LLM and tool pipelines
docs/DEVELOPMENT.md: dev setup and build
docs/API.md: internal API reference

Thanks

Built on open-source. See THANKS.md.

selene