Staks-sor/ai-free
Staks-sor/ai-free has 229 GitHub stars and 32 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 23:48 UTC. Last push 2026-08-20.
What you can do
- One local app: DeepSeek, Qwen and ChatGPT chats in one workspace.
- Developer interfaces: desktop UI, CLI, OpenAI-compatible API and Anthropic-compatible API.
- Code agent: /code mode with workspace file access and controlled command permissions.
- Memory and skills: long-term memory, memory graph and reusable task workflows.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Open-source local AI client and coding agent for DeepSeek, Qwen, ChatGPT and EconomyOS with memory, voice, browser tools, OpenAI/Anthropic-compatible APIs and VS Code.
Developer Toolsdocs/readme/README.en.md
OriginalAI Free
Free AI chats, a code agent, memory, and local APIs in one app
🌍 Choose your language
AI Free 0.4.25
A CLI and desktop app that brings free AI web chats into one interface. Currently supports DeepSeek, Qwen, and ChatGPT. Runs on macOS, Linux, and Windows.
⭐ Support the project
If AI Free saves you time, please star the repository. It helps other people discover the project.
- Donation card (OTP Bank):
2201 9604 2500 7505
✨ Features
- 💬 One interface: DeepSeek, Qwen, and ChatGPT conversations in one desktop window.
- 🔑 Easy sign-in: automatic browser login and session recovery for each provider.
- 📁 Project workspaces: multiple chats, each connected to its own folder.
- 🛠️ Code agent: workspace file access with a controlled command allowlist.
- 🧠 Memory and skills: long-term memory, a memory graph, and reusable workflows.
- 🔌 Local APIs: OpenAI-compatible and Anthropic-compatible endpoints for IDE integrations.
- 🎙️ Voice input: optional multilingual Parakeet V3, downloaded only when first used.
- ⚙️ Flexible settings: language, API, permissions, and agent controls.
📋 Requirements
- Node.js 18 or newer.
- npm.
- Internet access for AI providers and the initial Chromium installation.
- On Linux, Chromium system dependencies may also be required.
🚀 Installation
macOS and Linux
git clone https://github.com/Staks-sor/ai-free.git
cd ai-free
npm install
npm start
On Linux:
sudo npx playwright install-deps chromium
Windows
git clone https://github.com/Staks-sor/ai-free.git
cd ai-free
npm install
npm start
During the first launch, select the providers you want to connect and sign in through the browser window. Sessions are stored locally and reused on later launches.
⌨️ Main commands
| Command | Purpose |
|---|---|
npm start |
Start the desktop chat window |
npm run cli |
Start the terminal REPL |
npm run api |
Start the local compatible API on 127.0.0.1:4318 |
npm run login |
Sign in to DeepSeek again |
npm run login-qwen |
Sign in to Qwen again |
npm run login-chatgpt |
Sign in to ChatGPT again |
npm test |
Run the test suite |
🔌 Local API
Start the API server:
npm run api
OpenAI-compatible base URL:
http://127.0.0.1:4318/v1
API keys and provider-specific settings are available in the app under Settings → API.
📁 Project workspaces
When creating a chat, choose a project folder. Code-agent tools in that chat operate only inside the selected workspace. Recent folders remain available for quick selection.
🧠 Memory and skills
- Coder sends tasks directly to the code agent.
- Memory retrieves relevant previous fixes and stores useful outcomes.
- Skill auto selects a skill based on the task.
/skill <id> <task>selects a skill manually.
Detailed architecture: AI Free Brains and Skills Plan.
💾 Local data
Provider sessions and settings are stored outside the repository:
- DeepSeek and shared chat state:
~/.deepseek-cli/ - Qwen:
~/.qwen-cli/ - Memory and user skills:
~/.ai-free/
Tokens and cookies remain on the local machine. The chat and API servers listen on 127.0.0.1.
🧰 Troubleshooting
Detailed privacy-safe JSONL logs are stored in %USERPROFILE%\.ai-free\logs\ai-free.log on Windows and ~/.ai-free/logs/ai-free.log on macOS/Linux. Logs include request timing, HTTP status, provider/model metadata, retries, background tasks, tool calls and full error stacks. Prompt/response text is not stored and credentials are redacted. Rotation defaults to five files of 5 MiB each.
- Reconnect DeepSeek with
npm run login. - Reconnect Qwen with
npm run login-qwen. - Reconnect ChatGPT with
npm run login-chatgpt. - If Playwright Chromium is missing, run
npx playwright install chromium. - On Linux, run
sudo npx playwright install-deps chromiumif browser libraries are missing.
💬 Feedback and license
Found a bug or have an idea? Open an issue.
Personal-Use-Only. See LICENSE.