Skip to content
View linggen's full-sized avatar

Block or report linggen

Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
linggen/README.md

Linggen

Linggen

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

Release Apache 2.0 License Stars


Install

curl -fsSL https://linggen.dev/install.sh | bash
ling

Opens the web UI at http://localhost:9898. macOS and Linux.


What is Linggen?

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 analogy

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.


Yinyue — your desktop companion

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.


Apps built on Linggen

  • 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 .app available.
  • Sys Doctor — AI health analyst for your Mac. Disk, security, performance, dormant apps, buyer's guide. Bundled .app available.
  • 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.


Memory

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.


Add an app

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.


Where Linggen sits

  • 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.dev acts as a signaling relay; it does not see chat content.
  • Skills as the contract. Apps follow the open Agent Skills standard.

Remote access

ling login   # link to linggen.dev

Then open linggen.dev/app from any browser. P2P-encrypted tunnel back to your machine; no VPN, no port forwarding.


Documentation


License

Apache 2.0 — engine and bundled skills. Branded apps shipped from linggen-releases ship under their own terms.

Popular repositories Loading

  1. linggen-memory linggen-memory Public

    A local-first memory layer for AI (Cursor, Zed, Claude). Persistent architectural context via semantic search.

    Rust 108 5

  2. linggen linggen Public

    agents

    Rust 6 2

  3. skills skills Public

    Linggen skills

    JavaScript 2 1

  4. linggen-releases linggen-releases Public

    release apps

  5. linggen-vscode linggen-vscode Public

    vscode extension of Linggen

    TypeScript