BitCode

BitCode is a local-first desktop AI Agent GUI built for the DeepSeek API. It combines a polished PyQt6 interface, streaming Reasoner output, local encrypted settings, SQLite conversation history, and practical agent tools for web search, file parsing, and local Python execution.

Highlights

• DeepSeek-native API client for deepseek-v4-pro and deepseek-v4-flash
• Adjustable temperature, top_p, max_tokens, thinking, and reasoning_effort
• Streaming Reasoner panel for reasoning_content
• Agent tools for web search, file parsing, and optional local Python execution
• Local SQLite conversation management
• Export conversations to Markdown, TXT, or JSON
• Encrypted local configuration vault for API keys and preferences
• No custom cloud backend
• Dark, particle-driven desktop interface with responsive three-column layout
• Windows packaging workflow powered by PyInstaller

Screens

BitCode uses a three-panel desktop layout:

• Left: sessions and model switching
• Center: conversation, Reasoner output, and prompt composer
• Right: model parameters, tool switches, system prompt, and UI controls

Tech Stack

• Python 3.10+
• PyQt6
• httpx async streaming requests
• SQLite
• cryptography / Fernet / scrypt
• PyInstaller for Windows builds

Project Structure

BitCode/
├── docs/
│   ├── API_NOTES.md
│   ├── PACKAGING_WINDOWS.md
│   └── USER_GUIDE.md
├── scripts/
│   ├── build_windows_exe.bat
│   ├── build_windows_exe.ps1
│   ├── dev_run.sh
│   └── run_windows.bat
├── src/
│   └── deepseek_agent_gui/
│       ├── core/
│       ├── ui/
│       ├── __main__.py
│       └── main.py
├── tests/
├── LICENSE
├── pyproject.toml
├── requirements.txt
└── requirements-dev.txt

Quick Start

git clone https://github.com/zzy133131/BitCode.git
cd BitCode
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements-dev.txt
pip install -e .
bitcode

You can also run:

python -m deepseek_agent_gui

On first launch, BitCode asks for:

1. A local master password
2. A DeepSeek API key
3. The DeepSeek base URL, defaulting to https://api.deepseek.com

The API key and preferences are stored in an encrypted local vault. Conversation history is stored locally in SQLite.

Windows

To run from source on Windows, double-click:

scripts\run_windows.bat

To build a Windows executable, double-click:

scripts\build_windows_exe.bat

The executable is generated at:

dist\BitCode\BitCode.exe

More details: docs/PACKAGING_WINDOWS.md.

Development

python -m pytest
python -m ruff check src tests

Security

• API keys are encrypted locally with a key derived from the user's master password.
• Conversation history stays on the local machine.
• The Python code runner is disabled by default.
• Web search can be disabled for offline use, excluding DeepSeek API calls.

Repository Topics

Suggested GitHub topics:

deepseek ai-agent pyqt6 desktop-app local-first python sqlite encrypted-config windows

License

MIT License