mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-07-17 11:07:11 +08:00
02bc91f4af
The global build/ gitignore rule was silently excluding the PyInstaller spec, desktop requirements, and build script under desktop/build/, so the release workflow failed at "pip install -r requirements-desktop.txt" with a missing-file error. Re-include just those source files while keeping the build outputs (dist/, build-work/) and local venv ignored. Co-authored-by: Cursor <cursoragent@cursor.com>
CowAgent Desktop
Cross-platform desktop client for CowAgent, built with Electron + React + TypeScript.
Development
Prerequisites
- Node.js 18+
- npm or yarn
- Python 3.7+ (for the backend)
Setup
cd desktop
npm install
Run in Development
Start the renderer dev server and Electron together:
npm run dev
Or run them separately:
# Terminal 1: Start Vite dev server
npm run dev:renderer
# Terminal 2: Start Electron (after renderer is ready)
npm run dev:main
The app will automatically start the Python backend from the parent directory.
Build
# Build for current platform
npm run dist
# Build for macOS only
npm run dist:mac
# Build for Windows only
npm run dist:win
Build outputs are placed in the release/ directory.
Architecture
desktop/
├── src/
│ ├── main/ # Electron main process
│ │ ├── index.ts # Window management, IPC
│ │ ├── python-manager.ts # Python backend lifecycle
│ │ └── preload.ts # Context bridge for renderer
│ └── renderer/ # React UI (Vite)
│ └── src/
│ ├── api/ # HTTP client for backend APIs
│ ├── components/ # Reusable UI components
│ ├── hooks/ # React hooks
│ ├── pages/ # Page components
│ └── types.ts # TypeScript types
├── resources/ # App icons
├── package.json # Dependencies and build config
└── vite.config.ts # Vite config
How it Works
- Electron main process starts and creates the app window
- It spawns the Python backend (
app.py) as a child process - The React UI communicates with the Python backend via HTTP APIs
- SSE (Server-Sent Events) is used for streaming chat responses and live logs