Skip to content

README.md

Latest commit

 

History

History
139 lines (104 loc) · 3.48 KB

README.md

File metadata and controls

139 lines (104 loc) · 3.48 KB
Raw

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.

Python PyQt6 DeepSeek License

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