Saki Panel

A server ops panel with an agent that can see, change, and run.
High-risk work waits for your OK. Crashes get a fingerprint, a reviewed patch, and a rollback if it happens again.

https://github.com/user-attachments/assets/e404ea96-7a17-4af2-ab1f-d4a45af1caca

Why Saki? · Saki · Watch · Panel · Plugins · Quick Start · Architecture · Deploy

Saki Panel is a web console for instances, nodes, files, terminals, and permissions. Saki is not a sidebar chatbot — it reads live status, logs, metrics, and the file tree, then acts inside the same workspace.

You can tell it:

• Restart the Node service on node-02 and tail the last 50 lines.
• /var is filling up. Find what's using space and ask before deleting anything.
• Update the Minecraft server. Back up the world first.

Local models via Ollama or LM Studio work with no API key. Cloud providers and GitHub Copilot are optional.

Why Saki Panel? (Comparison with Alternatives)

Existing panels (MCSManager, 1Panel, Pterodactyl, aaPanel) are great at what they do — but they're all passive, manual tools. When a service crashes at 3 AM, they restart it blindly and leave the log-digging to you.

Pterodactyl is still the standard for commercial multi-tenant game hosting; 1Panel is solid for traditional Linux sites. If you want an AI-native panel with a 24/7 autonomous SRE, Saki Panel is built for you.

Screenshots

Dashboard — cluster overview, CPU / memory / disk, resource curves, node health, and recent audit:

Saki on the logs — the agent works inside the same workspace: live instance logs behind, Saki chat in front, asked to find out why a player keeps dying:

Saki Watch incident — a watched instance exits with code 1, the daemon fingerprints it, and diagnosis waits for your confirm:

Saki

Local, no cloud

SAKI_PROVIDER=ollama
SAKI_MODEL=llama3.2
SAKI_OLLAMA_URL=http://localhost:11434

Or pick OpenAI, Anthropic, DeepSeek, Qwen, Gemini, MiniMax, Zhipu, Moonshot, Doubao, or GitHub Copilot in Settings.

Saki Watch

When a watched instance exits unexpectedly:

1. Incident — Daemon records the exit and groups it by error fingerprint. No model call yet.
2. Confirm — You start diagnosis from the incident banner or the notification bell.
3. Scoped run — Agent reads logs and files. No shell, no deletes, no startup-command edits.
4. Review — Proposed diffs wait for you before anything is written.
5. Verify — Service restarts. Same crash again → files roll back to the pre-patch checkpoint.

Panel

• Dashboard — Cluster overview, CPU / memory / disk, node health, recent audit.
• Instances — Nine types, restart policies, logs, and process probes.
• Terminal — xterm.js over WebSocket, reconnects on drop, Minecraft color codes.
• Files — Browser, CodeMirror 6 editor, upload / download, zip / tar / rar / 7z in the background.
• Databases — SQLite, MySQL / MariaDB, PostgreSQL, Redis. Schema, rows, and queries in the panel.
• Nodes — One lightweight daemon per machine. Panel talks to them with node tokens.
• Tasks — Cron for commands, restarts, and maintenance, with run history.
• Access — RBAC, session timeout, login rate limits, full audit log.
• Templates — Reusable start commands, env, and deploy params.

Instance types

Plugins

Every surface can be restyled and extended. Saki Panel ships a Plugin Workshop — themes, skins, games, widgets and language packs install in one click, with no rebuild and no restart. A curated collection lives in the saki-plugins repository.

Plugin	Type	What it gives you
简约几何 · saki-theme-geo		Replaces the liquid-glass UI with a constructivist geometric shell: charcoal sidebar, cobalt accent, chamfered corners.
女仆装 · saki-skin-maid		Swaps every Saki expression and six-frame loop into a French maid outfit.
切水果 · saki-game-fruit-slice		An arcade fruit-slicer: swipe flying fruit, dodge bombs, chase combos.
日本語 · saki-locale-ja		A full Japanese interface pack for the panel.

Five plugin types are supported — theme, skin, game, widget and locale. Want to write your own? The plugin guide walks you from an empty folder to something the Workshop can see.

Quick Start

Requires Node.js ≥ 22.13 and npm ≥ 9.

git clone https://github.com/EthanChan050430/Saki-Panel.git
cd Saki-Panel
npm install
npx prisma db push --skip-generate
npm run dev

Platform scripts under scripts/ also handle port conflicts:

Default login: admin / admin123456

Change JWT_SECRET, ADMIN_PASSWORD, and DAEMON_REGISTRATION_TOKEN before anything is reachable from the network.

Architecture

┌──────────────┐   HTTP / WS + JWT    ┌──────────────┐   HTTP / WS + token   ┌──────────────┐
│     Web      │ ◄──────────────────► │    Panel     │ ◄──────────────────► │    Daemon    │
│  React 19    │                      │  Fastify 5   │                      │  Fastify 5   │
│  Vite 6      │                      │  Saki Agent  │                      │  Node agent  │
│  :5478       │                      │  :5479       │                      │  :5480       │
└──────────────┘                      └──────────────┘                      └──────┬───────┘
                                                                                   │ spawn
                                                                                   ▼
                                                                            ┌──────────────┐
                                                                            │  Instances   │
                                                                            └──────────────┘