A local AI app engine — and your general-purpose personal assistant.
Two faces of one runtime: out of the box, the assistant chats and acts;
install skills and the same runtime hosts them as full apps.
Website · Apps · Skills · Docs · Discord
curl -fsSL https://linggen.dev/install.sh | bash
lingOpens the web UI at http://localhost:9898. macOS and Linux.
Architecturally, Linggen is the root system for AI agents. The core runtime manages agent processes, communication, and execution; everything else (skills, agents, missions) grows on top as files. An "AI app" in Linggen is a skill, an agent, or a mission — markdown + scripts, not code plugins. The runtime gives every app a process, syscalls (built-in tools), a filesystem (memory), permissions, and a network surface (P2P rooms).
Apps drop into a folder and run.
| OS | Linggen |
|---|---|
| Process | Agentic loop — one running agent |
| Interrupt | User message queue — checked each iteration |
| Thread / Fork | Subagent delegation — concurrent child execution |
| Syscall | Tool call — built-in tools are the kernel API |
| Dynamic library | Skill — loaded at runtime, no code changes |
| Cron job | Mission — scheduled agent / app / script |
| Driver | Model provider — Ollama, Claude, GPT, Gemini, Bedrock |
| Filesystem | Memory store — core markdown + LanceDB RAG via ling-mem |
| Process privilege | Permission modes (chat / read / edit / admin) + path scoping |
| Network share | Rooms — share models with peers over P2P WebRTC |
Full table and design principles in doc/product-spec.md;
vision and roadmap in doc/insight.md.
A VRM avatar and conversational companion built into the runtime — the face the agents wear. She reads the room (whether you're typing, reading, or away), voices the moments that matter in her own words, and gives the agents a way to talk to each other and to you.
- She heralds your agents. When one is blocked waiting on you, fails, or finishes a background job, Yinyue says so — and stays quiet on the routine.
- Relay an answer. When an agent is parked on a question or a permission, just tell Yinyue "approve" — she carries your word back and it unblocks.
agent_chat. Agents message each other. Ask Yinyue to have Ling introduce itself and the message lands in your chat ([Yinyue]: …) and Ling replies; tell Ling to make Yinyue dance and she dances. A loop-break keeps you in the loop.- She's present. Gestures and moods (
Express), occasional unprompted remarks, a local voice with lip-sync.
She's an ordinary Linggen session on the yinyue agent — swap her model, edit
her persona, or build another companion the same way. See
doc/yinyue-companion-spec.md.
- CFO — Personal CFO. Import bank and card CSV/PDF exports; it builds a spend report, catches subscriptions and price hikes, answers "why did I spend more this month?", and drafts cancellation emails. Data never leaves the machine. Bundled
.appavailable. - Sys Doctor — AI health analyst for your Mac. Disk, security, performance, dormant apps, buyer's guide. Bundled
.appavailable. - Pulse — GTM brain for solo founders. Reads your configured trends and feeds, then drafts on-voice posts for X and Reddit at launch time.
- Model Sharing — Rooms. Open one and let friends use your models over P2P WebRTC. No keys for the consumer, no cloud middleman, owner controls budget and tools.
Skills, agents, missions — all files. New apps are a folder away. Browse community skills at linggen.dev/skills.
Linggen's filesystem is a memory store. Facts live as core markdown plus a
LanceDB semantic index — typed entries, embeddings, and first-class forgetting,
reachable from Linggen, Claude Code, or Codex. Powered by
ling-mem.
Drop a markdown file in ~/.linggen/ — available immediately, no restart:
---
# ~/.linggen/agents/reviewer.md
name: reviewer
description: Code review specialist.
tools: ["Read", "Glob", "Grep"]
model: claude-sonnet-4-20250514
---
You review code for bugs, style issues, and security vulnerabilities.Skills (~/.linggen/skills/<name>/SKILL.md) and missions (cron-scheduled
agent / app / script) follow the same drop-in pattern. Skills use the open
Agent Skills standard and work in Claude Code
and Codex too.
- Local-first. Runtime, data, and inference (when you pick local models) live on your machine. Cloud is opt-in via your own API keys.
- Model-agnostic. Any model — Ollama, Claude, GPT, Gemini, DeepSeek, Groq, OpenRouter. Routing policies (
local-first,cloud-first, custom) decide which model handles each request. - App platform, not a single product. Coding is one app among many.
- P2P, not centralized. Remote access and model sharing flow over WebRTC data channels.
linggen.devacts as a signaling relay; it does not see chat content. - Skills as the contract. Apps follow the open Agent Skills standard.
ling login # link to linggen.devThen open linggen.dev/app from any browser. P2P-encrypted tunnel back to
your machine; no VPN, no port forwarding.
- Design docs — architecture, specs, internals
- Product spec — system definition + design principles
- Insight — vision, roadmap, problems Linggen solves
- Skill spec — how to write skills
- Full docs — guides and reference
Apache 2.0 — engine and bundled skills. Branded apps shipped from linggen-releases ship under their own terms.
