claude-desktop-app  by pretend1111

Desktop AI assistant with Claude's agentic power and claude.ai interface

Created 3 weeks ago

New!

340 stars

Top 81.1% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

This project offers a desktop AI assistant for users facing regional access barriers to claude.ai. It merges the familiar claude.ai frontend with the powerful Claude Code open-source engine, enabling local interaction via existing Claude API access (including transit station APIs). This bypasses geographical/payment hurdles while retaining advanced agent capabilities for a seamless, feature-rich chat experience.

How It Works

An Electron shell houses a React frontend (Vite) communicating with a Node.js bridge server. This server features a bidirectional Anthropic ↔ OpenAI proxy, enabling integration with diverse LLM providers. It connects the frontend to the Claude Code engine (Bun runtime), exposing over 19 tools for file I/O, command execution, web searching, and agent-based task delegation, offering a unified local AI interface.

Quick Start & Requirements

  • Installation: Download pre-built binaries from Releases (Windows .exe, macOS .dmg/.zip, Linux .AppImage/.deb).
  • Build from Source: Requires Node.js 20+ and Bun. Clone, npm install, cd engine && bun install && cd .., then npx vite build and npx electron .. Git Bash needed for Claude Code engine on Windows.
  • Usage Modes: Self-host with API Key/Base URL (Settings) or use paid Clawparrot service (registration required at clawparrot.com).

Highlighted Details

  • UI Parity: 1:1 claude.ai interface (dark mode, streaming output, collapsible thinking blocks, tool cards, Artifacts panel).
  • Universal Model Integration: Bidirectional Anthropic/OpenAI proxy supports Claude transit, Qwen, DeepSeek, GLM, GPT, Gemini, and compatible providers.
  • Full Agent Suite: Integrates Claude Code's native agent capabilities: file I/O, Bash execution, web search/fetch, parallel sub-agent tasking (Deep Research), custom Skills, and Projects knowledge bases.
  • Artifacts Visualization: Real-time preview/editing of generated HTML/JSX in a dedicated panel, supporting dual-panel comparison.
  • Automatic Updates: Integrated electron-updater handles background checks and seamless updates on relaunch.

Maintenance & Community

The project welcomes Issues and PRs, advising users to open an Issue for significant feature proposals. The roadmap indicates future development of "Cowork" (collaboration) and "Code" (IDE-like) modes beyond the current "Chat" functionality.

Licensing & Compatibility

The application is licensed strictly for non-commercial use only, as detailed in the LICENSE file. This restriction is the primary compatibility note for potential adopters.

Limitations & Caveats

The primary limitation is the explicit non-commercial use restriction. Only the "Chat" mode is implemented; "Cowork" and "Code" features are planned. Building from source requires specific Node.js and Bun environments.

Health Check
Last Commit

4 days ago

Responsiveness

Inactive

Pull Requests (30d)
7
Issues (30d)
15
Star History
346 stars in the last 25 days

Explore Similar Projects

Feedback? Help us improve.