English | 简体中文

xopc

Your AI assistant for work and everyday life.
Think things through, get help with tasks,
and make time for what matters to you.
Open-source. Local-first. Runs on a computer you choose.

Download the desktop app → · Read the docs · Watch demos and tutorials

Our vision

A future where everyone has their own AI assistant, with ongoing help across work and everyday life and more time and energy for what matters to them.

We want AI to take on more tedious, repetitive, and time-consuming tasks. How you spend the time is up to you. Read our philosophy.

Two ways to start in one xopc

Talk with Ada. Ada is the personal Agent inside xopc; no separate installation is needed. Share your background, response preferences, and a goal. Delegate a task when you need a hand, keep talking, then return to the result. Meet Ada.

Open your workspace. Bring files and a goal to organize material, analyze data, change code, or prepare a report. Keep conversations, deliverables, and project context together so you can continue later. Workspace guide.

Conversation and the workspace are two ways to begin; both can help with work and everyday life. From organizing work material to planning a weekend outing, start in the same xopc. Available capabilities depend on the connected models, tools, and permissions.

Finish something real

Your goal	Try this	Check the result
Plan an easy weekend	“I want to take my camera out this weekend, but only have half an hour. Help me put together a one-page plan.”	Timing, details to verify, and an editable plan
Resume a project	“Use this project's notes and tasks to explain what is blocked and suggest the next step.”	Sources, unresolved decisions, and next action
Turn material into a report	“Combine these sales files into a summary. Keep sources, calculations, and exceptions.”	Saved file, totals, and exceptions
Delegate and keep talking	“Turn this week's plan into a one-page file and tell me when it is ready. Let's keep discussing next week.”	Task card, actual file, and revisions

File work requires the relevant access, tools, or skills. Voice, image generation, browser access, and external services need their own setup. Delegate and receive results · Practical tutorials (videos and detailed walkthroughs are currently in Chinese).

Core capabilities

Capability	What it helps you do
Context and memory	Keep conversations, project background, and understanding you can review, correct, or delete
Delegation and delivery	Delegate tasks, answer follow-up questions, receive artifacts, and check acceptance criteria
Files and projects	Work with authorized material and retain files, notes, execution records, and next actions
Tools and connections	Enable skills, MCP, connectors, browser control, images, and voice as needed
Access across devices	Desktop, web, terminal, mobile, Telegram, WeChat, and Feishu/Lark

Computer Use is currently a macOS desktop preview requiring a compatible GUI model and native permissions. Mobile capabilities vary by platform and version; the Agent runs on the connected computer.

Get started

Desktop app

1. Download xopc for macOS, Windows, or Linux.
2. Connect XOPC Cloud, your own provider API key, or a local model service.
3. Open the personal Agent or Chat. Try a small request, then bring in real material.

Desktop installation · Model setup.

Terminal installation

macOS, Linux, WSL:

curl -fsSL https://xopc.ai/install.sh | bash
xopc onboard --quick
xopc

Windows PowerShell:

irm https://xopc.ai/install.ps1 | iex
xopc onboard --quick
xopc

With Node.js 26.12.1+ already installed, use pnpm add -g @xopcai/xopc. The terminal quick start includes mirror and troubleshooting guidance.

Continue on mobile

See distribution channels and pairing. Scan the code and approve the connection on your computer, then review progress and send instructions. Keep the computer awake and xopc running.

Data and control

Core state lives under ~/.xopc/ on your machine by default. Use cloud or local models; cloud services process the request context, images, or audio sent to them. Connecting to XOPC Cloud does not automatically upload your entire local database or workspace.

Authorize sources, tools, and channels as needed. Execution confirmation depends on tool policy and the scope you authorize; browser control does not prompt for every click. Define boundaries and ask to review before sending, deleting, purchasing, or changing an account. Privacy and memory.

Find your guide

You want to…	Read
Set up your personal assistant	Meet Ada
Delegate and refine a result	Task delivery
Work with files and projects	Workspace
Review results and retry	Task acceptance
Add services and capabilities	Models · Skills · MCP · Connectors
Configure and extend an instance	Configuration · Extensions · XOPC Platform
See recent changes	What's new · GitHub Releases

Community

Join the xopc community to ask questions, share what you are building, and help shape the project.

Channel	Best for
GitHub Discussions	Questions, ideas, and searchable technical discussions
Discord	Real-time chat, showcases, and contributor coordination
WeChat community	Chinese-language discussion, onboarding help, and release updates
GitHub Issues	Confirmed bugs and actionable feature requests

Read the community guide and Code of Conduct before participating. Report security vulnerabilities through GitHub Security Advisories, not in a public community channel.

---

FAQ

Is xopc a hosted service? — The xopc application runs on your machine, with configuration and state stored under ~/.xopc/ by default. It can remain standalone or connect explicitly to XOPC Cloud or a private enterprise platform; connecting does not move the local database automatically.

Does local-first mean data never leaves my computer? — Not necessarily. If you select a cloud model, conversation content and context relevant to the request are sent to that model provider. Use a local model and review source and tool permissions for work that must remain on-device.

Does xopc remember everything about me automatically? — No. User understanding can be reviewed, confirmed, corrected, and deleted, and an unconfirmed inference should not become an authoritative fact. Passwords, keys, and other highly sensitive information do not belong in the memory system.

Do I need a paid cloud model? — No. Bring your own keys, or use local models (Ollama, LM Studio, vLLM).

What is the fastest way to try it? — Desktop app for GUI users, or xopc onboard --quick && xopc for terminal.

How is this different from another chat UI? — Chat is only one surface. xopc preserves understanding, long-term goals, projects, tasks, decisions, and run history so the same assistant can continue working across time and surfaces.

Can I use it from my phone or messengers? — Yes. Pair the mobile app by QR code, or configure Telegram, WeChat, or Feishu/Lark via the gateway.

Have a question? — Ask on GitHub Discussions.

---

Security

xopc handles personal context and may be given execution tools, so capability boundaries matter as much as model choice:

• enable only the data sources, tools, and channels you currently need;
• before using a cloud model, understand what context may be sent to the provider;
• treat all inbound messenger content as untrusted input and prefer pairing or allowlist for DMs;
• keep gateway bind addresses, access tokens, and API keys private;
• preserve human confirmation for sending, deleting, purchasing, and other high-impact actions.

See User understanding and privacy, channel security, and the configuration reference.

---

Contributing

pnpm install && pnpm run dev    # CLI via tsx
pnpm run dev:gateway            # dev gateway uses ~/.xopc-dev + info logs
pnpm run build && pnpm run test:all && pnpm run lint

AGENTS.md · CONTRIBUTING.md

Issues: Bug report · Feature request · Q&A Discussions · Security advisory (not public issues)

Tech stack: TypeScript, Node.js ≥ 26.12.1, pnpm workspace. Built-in LLM layer via @earendil-works/pi-ai, React gateway console, Electron desktop.

Credits

• LLM layer: @earendil-works/pi-ai · Agent runtime: @earendil-works/pi-agent-core
• User understanding: inspired by OpenWiki's evidence-to-knowledge approach, reimplemented as a native XOPC capability with governed synthesis and per-turn context planning — see User understanding
• Inspired by openclaw/openclaw and NousResearch/hermes-agent

---

_{Made with care by xopcai · xopc.ai}

Code signing policy

Windows signing application status, proposed roles, and desktop privacy disclosures are documented in the Code signing policy. Current downloads are not SignPath-signed.