ai-free

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.

Generate Convert Improve

Install / Use

npx skills add Staks-sor/ai-free

Installs into whichever agent you are using.

About this skill

📦

Other

Other agent config

Quality Score

90/100

Skill content

View source on GitHub

<h1 align="center">AI Free</h1> Local AI client for DeepSeek, Qwen and ChatGPT with API, code agent, memory and skills

AI Free turns free AI web chats into a local developer tool.

Use DeepSeek, Qwen and ChatGPT from one desktop window, CLI, compatible APIs, IDE integrations and code-agent workflows — with local memory, skills and workspace-aware chats.

Good for:

developers who want a free local AI coding assistant;
people who use web AI chats but want API/CLI access;
experiments with agents, memory, skills and IDE automation.

What Is AI Free?

AI Free is an open-source local AI client and developer tool for using free web AI chats as a practical coding assistant. It connects DeepSeek, Qwen and ChatGPT to a desktop app, command line interface, local OpenAI-compatible API, Anthropic-compatible API, VS Code plugin, memory, skills and workspace-aware code-agent workflows.

People usually look for this project as a free AI coding assistant, local AI client, OpenAI-compatible API for Qwen or DeepSeek, ChatGPT desktop client, Qwen VS Code extension, DeepSeek code agent, free alternative for AI developer tools, or local agent with memory and skills.

Popular Use Cases

Run Qwen, DeepSeek and ChatGPT from one local desktop app.
Use Qwen or DeepSeek through an OpenAI-compatible API endpoint.
Connect local AI chats to VS Code, Continue, Kilo Code and other developer tools.
Ask a code agent to read and edit a project folder with controlled command permissions.
Keep local memory, skills and reusable workflows for repeated development tasks.
Build agent pipelines, Telegram workflows and browser automation around free web AI providers.

✨ Highlights

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.
Project instructions: hierarchical AGENTS.md files are reloaded before every code-agent task; nested files apply to their own directory tree.
IDE-friendly: works with tools such as Continue, Kilo Code and PyCharm ACP-compatible flows.
Local-first sessions: provider browser sessions and app state are stored on your machine.

🌍 Выберите язык / Choose your language

Локальный AI-клиент, который превращает веб-чаты DeepSeek, Qwen и ChatGPT в инструмент для разработчика: окно чатов, CLI, совместимые API, /code-агент, память, skills и IDE-интеграции.

⭐ Понравилось? Поставь звезду

Если AI Free экономит тебе время, поставь звезду на GitHub — это помогает проекту появляться в поиске и рекомендациях.

💳 Поддержать развитие

Если хочется отблагодарить материально — любая сумма даёт сигнал, что проект имеет смысл, и мотивацию добавлять новые фичи (мультипровайдер Qwen/Kimi, attachments, стриминг ответов и т.д.).

Карта (ОТП Банк): 2201 9604 2500 7505

Спасибо!

Архитектурно проект разделён на модули в src/ (auth, browser, providers, code-agent, memory, skills, agent-orchestrator, state, window-app, api, cli). Точка входа — bin/deepseek.mjs. Юнит-тесты запускаются командой npm test во встроенном Node test runner; точное число зависит от текущей версии. Архитектура памяти и skills — docs/AI_FREE_BRAINS_AND_SKILLS_PLAN.md. Сценарий для видео — docs/VIDEO_SCRIPT.md.

✨ Что внутри

💬 Три провайдера: DeepSeek, Qwen и ChatGPT в одном окне с выбором модели при создании беседы.
🔑 Авто-логин DeepSeek: один вход через браузер, затем тихое восстановление сессии или окно re-login.
🔐 Авто-логин Qwen и ChatGPT: отдельные профили и локальные сессии для каждого провайдера.
🪟 Окно чатов (localhost:4317): несколько параллельных бесед, каждая привязана к своей папке-проекту.
⌨️ CLI-режим: REPL в терминале для скриптовых сценариев и быстрых вопросов.
🛠️ /code агент: доступ к файлам workspace и разрешённым командам.
🧠 Memory: долговременная память агента — SQLite FTS5 + Markdown vault (~/.ai-free/memory/). Переключатель в topbar, просмотр в Settings → Агент.
AGENTS.md: правила проекта загружаются перед каждой агентской задачей. Корневой файл действует на весь workspace, вложенный — на свою директорию и её подкаталоги и имеет приоритет над родительским.
🔗 Memory graph: связи task ↔ file ↔ bug ↔ fix; расширяет контекст при повторных задачах.
⚡ Skills: встроенные code-review, bug-fix, video-script; auto-match по задаче; /skill <id> <task>.
Agent orchestrator: перед /code собирает актуальные AGENTS.md, memory и skill в system prompt.
🔌 Совместимые API (localhost:4318): OpenAI и Anthropic для Kilo Code, Continue и других IDE.
🎙️ Голосовой ввод: Parakeet V3 скачивается отдельно только при первом использовании.
📁 Файловый браузер: при создании чата можно выбрать папку или создать новую.

Версия продукта

Текущий релиз desktop/CLI/API, расширения VS Code и исходников плагина PyCharm — AI Free 0.4.22.

Что вошло в 0.4.22: release notes.

📋 Требования

Везде нужно:

Node.js ≥ 18 (nodejs.org). Проверить: node -v.
npm (идёт в комплекте с Node).
Подключение к интернету и установки Chromium (~150 МБ).

Опционально:

Google Chrome. Если установлен — программа использует его как «настоящий» браузер (свежий, со всеми обновлениями безопасности). Если нет — автоматически качается Playwright`овский Chromium.

🚀 Установка

macOS / Linux

git clone https://github.com/Staks-sor/ai-free.git ai-free
cd ai-free
npm install

npm install сам качает Chromium (~150 МБ) через postinstall-хук — отдельная команда не нужна.

Если ты на Linux, добавь зависимости системы для Chromium (один раз):

sudo npx playwright install-deps chromium

Это поставит libnss3, libgbm, libasound2 и пр. — без них Chromium не запустится.

Windows

git clone https://github.com/Staks-sor/ai-free.git ai-free
cd ai-free
npm install

В PowerShell или Windows Terminal — обе оболочки работают. CMD тоже, но Windows Terminal удобнее для интерактивного ввода (например, при npm run save-creds).

🎬 Первый запуск

npm start

Что произойдёт:

Если ни один провайдер ещё не подключён — консольный welcome-экран: выбери 1 (DeepSeek), 2 (Qwen) или 1,2 (оба).
Для каждого выбранного провайдера откроется окно логина в Chrome/Chromium — зайди один раз (Google OAuth, email/пароль, captcha).
DeepSeek: окно закроется само после первого успешного API-запроса; сессия → ~/.deepseek-cli/.
Qwen: окно закроется, когда в cookies появится JWT (token); сессия → ~/.qwen-cli/.
Откроется рабочее окно чатов (localhost:4317).

Повторный запуск — npm start без welcome, если auth уже есть. Qwen можно добавить позже: «+ New chat» → Qwen → «нажми — подключить».

📁 Где что хранится

Служебные файлы — вне проекта, в домашней папке пользователя.

DeepSeek (~/.deepseek-cli/ на Unix, %USERPROFILE%\.deepseek-cli\ на Windows):

~/.deepseek-cli/
├── auth.json              # cookies + userToken (mode 0600 на Unix)
├── browser-profile/       # Chromium-профиль с сессией DeepSeek
├── state.json             # все чаты (глобально)
├── state.backup.json
├── settings.json          # allow-list команд для /code
└── credentials.json       # email + пароль (опционально, только DeepSeek)

Qwen (отдельно, не смешивается с DeepSeek):

~/.qwen-cli/
├── auth.json              # cookies + JWT token
└── browser-profile/       # Chromium-профиль для chat.qwen.ai и browser-proxy

ChatGPT (отдельно от DeepSeek и Qwen):

~/.chatgpt-cli/
├── auth.json              # cookies + session data
└── browser-profile/       # Chromium-профиль для chatgpt.com

Memory + Skills (общие для всех провайдеров):

~/.ai-free/
├── memory/
│   ├── memory.db          # SQLite FTS5 (+ graph tables)
│   ├── vault/             # Markdown-файлы заметок {id}.md
│   └── graph.json         # fallback графа (Node < 22)
└── skills/                # пользовательские skills (builtins в репо)

Чаты и настройки /code — в ~/.deepseek-cli/state.json (общие для всех провайдеров).

🧹 Полное удаление

Есть два уровня удаления:

Удалить только код приложения — чаты, токены, browser-сессии, memory и skills останутся в домашней папке.
Удалить полностью — вместе с чатами, авторизацией, локальной памятью, skills, browser-профилями и плагином VS Code.

1. Удалить desktop/local версию без удаления данных

Если AI Free был установлен через git clone, закрой приложение и удали папку проекта:

# macOS / Linux
rm -rf ~/path/to/ai-free

# Windows PowerShell
Remove-Item -Recurse -Force "$env:USERPROFILE\path\to\ai-free"

Замени ~/path/to/ai-free или $env:USERPROFILE\path\to\ai-free на реальный путь, куда был клонирован проект.

2. Полное удаление desktop/local версии вместе с данными

Это удалит:

чаты и настройки: ~/.deepseek-cli/state.json, settings.json;
DeepSeek-сессию и browser-профиль: ~/.deepseek-cli/;
Qwen-сессию и browser-профиль: ~/.qwen-cli/;
ChatGPT-сессию и browser-профиль: ~/.chatgpt-cli/;
memory, skills и установленные плагины AI Free: ~/.ai-free/.

# macOS / Linux
rm -rf ~/.deepseek-cli ~/.qwen-cli ~/.chatgpt-cli ~/.ai-free

# Windows PowerShell
Remove-Item -Recurse -Force `
  "$env:USERPROFILE\.deepseek-cli", `
  "$env:USERPROFILE\.qwen-cli", `
  "$env:USERPROFILE\.chatgpt-cli", `
  "$env:USERPROFILE\.ai-f

Truncated for display — read the full file on GitHub.

Related Skills

Agent-Reach

84.4k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

headroom

73.4k

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

ruflo

73.0k

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

nanobot

48.5k

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps

Staks-sor

View profile

View on GitHub

GitHub Stars210

CategoryAutomation

Updated1mo ago

Forks24

Staks-sor/ai-free

Languages

JavaScript

Security Score

88/100

Audited on Aug 20, 2026

1 medium