qqqqqf-q/Arkloop

干净、强大、属于你的 AI Agent 平台 --AI agents, without the clutter.

Arkloop – A Local‑First AI Agent Platform

What it is – Arkloop is an open‑source desktop application that lets you run conversational AI agents entirely on your own machine. It bundles a Go‑based backend, a React web UI, and an Electron shell, so you get a full‑featured chat interface, multi‑model routing, tool calling, and persistent memory without any external servers.

Why it matters – Most AI chat tools rely on cloud services or require you to set up separate backend components (databases, message queues, etc.). Arkloop collapses everything into a single embedded process with a local SQLite store, giving you privacy, offline capability, and a simple install experience across macOS, Linux, and Windows.

Core Features

Feature	What you get
Multi‑Model Routing	Connect to OpenAI, Anthropic, Gemini, or any OpenAI‑compatible API. You can prioritize models and supply your own API keys.
Agent Runtime	Built‑in tool calling, MCP servers, and “ClawHub” skills. Supports spawning sub‑agents and scheduling jobs.
Memory	Plain‑text notebook by default; optional semantic memory (Nowledge). Can be disabled for a stateless bot.
Channels	Export the same agent to Telegram, Discord, QQ, Feishu, and WeChat bots, with scheduled heartbeat runs.
Custom Personas	Separate system prompts, tool allow‑lists, budget caps, and executor types per persona.

Getting Started

Desktop app – Download the latest release for your OS from the GitHub Releases page. The installer includes the runtime; just launch the app.
CLI – After the first desktop launch you can install the ark command‑line tool. Run ark web to start the same local server headlessly.
Package managers – brew install qqqqqf-q/arkloop/arkloop (macOS) or yay -S arkloop-bin / arkloop-git (Arch Linux).
One‑liner for headless Linux – A curl‑pipe command fetches the appropriate binary and starts the web UI on 0.0.0.0.

Architecture at a Glance

Component	Tech Stack	Role
Desktop	Electron	Native shell that embeds the Go runtime and serves the UI.
Runtime	Go	Single process providing the API, worker logic, SQLite storage, and an in‑process event bus.
Web UI	React + TypeScript	Chat interface; bundled into the desktop app and also served by `ark web`.
CLI	Go	`ark` executable – headless entry point to the same runtime.

All data lives locally in a SQLite database; there are no external services like Postgres, Redis, or message queues.

Development & Contribution

Frontend – pnpm install then pnpm dev inside src/apps/desktop for hot‑reloading the Electron app.
Headless mode – Build the web UI with pnpm build and run the Go entry point: go run ./src/services/cli/cmd/ark web.
CI – bin/ci-local quick runs the local continuous‑integration checks.
Contributions are welcomed; even non‑code feedback is encouraged via GitHub issues.

License

Arkloop uses a custom “Arkloop License”, a modified Apache 2.0 license that adds:

Multi‑tenant restriction – You may not use the code to run a multi‑tenant SaaS without permission.
Brand protection – The logo and copyright notices must remain unchanged.

Community & Support

Telegram group – https://t.me/Arkloop_io
Security – Report vulnerabilities by email (qingf622@outlook.com) per the SECURITY.md.
Sponsors – Individual supporters are listed in the README.

Bottom line – Arkloop gives developers and power users a clean, self‑contained environment to experiment with AI agents, try out multiple LLM providers, and expose bots to popular messaging platforms—all without leaving your laptop.