Skip to content
Projects

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.

How these counts are measured

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 Tools

docs/readme/README.en.md

Original

AI Free

Free AI chats, a code agent, memory, and local APIs in one app

🌍 Choose your language

Русский English Español Português Deutsch Français 中文 हिन्दी العربية

Version macOS, Linux, Windows Node.js 18+ DeepSeek, Qwen, ChatGPT

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 chromium if browser libraries are missing.

💬 Feedback and license

Found a bug or have an idea? Open an issue.

Personal-Use-Only. See LICENSE.