桌面 AI 智能体 · Desktop AI Agent
Zero cgo · Native UI · Cross-compilable
Quick Start · Project Docs (Chinese) · Build and Release
Microlight runs on macOS, Windows, and Linux. Connect it to an OpenAI-compatible model provider, keep conversations and drafts on your device, and control how the agent accesses files, runs commands, and uses the network.
- Responsive native UI. MyGo renders the interface without an embedded browser. Replies stream into the chat as they arrive, and SQLite keeps history and drafts on the device.
- Model switching. Configure multiple providers and switch providers or models from the chat.
- Rich conversations. Paste images and files, read streamed replies with Markdown and LaTeX, and keep alternate replies in the same conversation when you edit a message or regenerate a response.
- Workspace tools. Let the agent read and edit files, run commands, use Skills, and connect to MCP servers. Review tool calls and file changes in the chat.
- Session recovery. Restore conversations, drafts, and pending questions after restarting. Long conversations can automatically summarize earlier turns to stay within the model's context budget.
Install with Go 1.27.3 or later, then launch Microlight from your terminal.
macOS and Linux
CGO_ENABLED=0 go install github.com/ggdream/microlight@latest
microlightWindows (PowerShell)
$env:CGO_ENABLED = '0'
go install github.com/ggdream/microlight@latest
microlight.exeIf double-clicking
microlight.exeopens a console window, rerun the install command with-ldflags="-H=windowsgui"aftergo install.
If your terminal can't find the executable, add the directory returned by go env GOBIN to your PATH, or run the executable directly from that directory. If GOBIN is empty, look in the bin directory under your Go workspace (go env GOPATH).
Open Settings → Model and enter your provider's Base URL, Model ID, and API key. Select Test Connection, then Save Settings. To send images, choose a model that supports image input.
Microlight stores conversation history in a local SQLite database. Model requests go to your selected provider, and MCP tool calls can communicate with the servers you configure. Local data and model requests (Chinese)
Microlight builds with the standard Go toolchain and CGO_ENABLED=0. Cross-compile the executable from the repository root by setting GOOS and GOARCH. A C compiler is unnecessary for these builds.
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o microlight.exe .
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o microlight-linux-amd64 .The executable uses platform APIs at runtime. On Linux, the desktop UI requires GTK 3. The project docs cover MyGo packaging, session storage, tool permissions, A2UI, and CI. Project documentation (Chinese)
Microlight is licensed under the Apache License 2.0. Bundled third-party materials retain their respective licenses.