CLI и десктопное окно для бесплатных AI-веб-чатов в одном интерфейсе. Сейчас: DeepSeek + Qwen. На очереди: Kimi, Mistral, Claude.ai. Кросс-платформенно — macOS, Linux, Windows.

Если проект сэкономил тебе время — поставь звезду на GitHub. Это бесплатно, занимает секунду, но реально помогает: больше звёзд → выше в выдаче → больше людей найдёт.

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

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

Спасибо!

Архитектурно проект разделён на модули в src/ (auth, browser, deepseek, providers/qwen, code-agent, state, window-app, api, cli). Точка входа — bin/deepseek.mjs. Юнит-тесты: npm test (97 кейсов, встроенный Node test runner). Подробности — REFACTOR_NOTES.md.

• Два провайдера: DeepSeek (chat.deepseek.com) и Qwen (chat.qwen.ai) — в одном окне чатов, переключение при создании беседы.
• Авто-логин DeepSeek: один раз заходишь через браузер (Google OAuth / email-пароль / captcha). Дальше сессия подхватывается из Chromium-профиля; при протухании — тихий refresh или окно re-login.
• Авто-логин Qwen: отдельный профиль и auth.json; тихий refresh из профиля, re-login из UI («нажми — подключить») или npm run login-qwen.
• Окно чатов (localhost:4317): несколько параллельных бесед, каждая привязана к своей папке-проекту.
• CLI-режим: REPL в терминале для скриптовых сценариев и быстрых вопросов.
• /code агент: доступ к файлам workspace и whitelist-командам (DeepSeek и Qwen).
• OpenAI-совместимый API (localhost:4318): для Kilo Code, Continue и других IDE.
• Файловый браузер: при создании чата можно открыть проводник, выбрать папку или создать новую.

Везде нужно:

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

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

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

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 не запустится.

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

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

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

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

Запуск OpenAI-совместимого API (отдельный процесс):

npm run api
# → http://127.0.0.1:4318/v1

Если уже открыто окно чатов (npm start), тот же API доступен прямо на порту окна: http://127.0.0.1:4317/v1. Base URL и ключи есть в Settings. Для DeepSeek и Qwen создаются отдельные ключи формата sk-...; каждый ключ переиспользуется из ~/.deepseek-cli/settings.json и не дублируется.

Если окно не нужно, запусти:

npm run server

Это поднимает тот же сервер на http://127.0.0.1:4317 и тот же API на http://127.0.0.1:4317/v1, но Chromium-окно не открывается. Основные события чатов, API-запросов и /code-задач печатаются в консоль.

Qwen использует отдельный Chromium-профиль и API через встроенный browser-proxy (подпись bx-ua на стороне chat.qwen.ai). Без логина Qwen в чатах не появится.

1. npm start
2. «+ New chat» → провайдер Qwen
3. Если подпись «нажми — подключить» — клик по карточке Qwen
4. Подтверди диалог → откроется chat.qwen.ai → залогинься → окно закроется само

npm run login-qwen

1. Залогинься в обычном Chrome на chat.qwen.ai
2. Экспортируй cookies расширением (Cookie Editor, EditThisCookie) в JSON
3. Импорт:

npm run import-qwen -- /path/to/cookies.json

Куки попадут и в auth.json, и в browser-profile — API и окно чатов увидят одну сессию.

Как у DeepSeek: при протухшей сессии программа сначала пробует тихий refresh из ~/.qwen-cli/browser-profile (без окна). Если не вышло — открывает окно логина. В окне чатов и в API (node api/server.mjs) это встроено.

Перед Qwen-чатом нужен хотя бы один успешный login-qwen или импорт — иначе нечего обновлять.

Если у тебя обычный email-вход (не Google OAuth) и хочется полный автомат:

npm run save-creds

Спросит email и пароль (ввод пароля скрытый). Сохранит в ~/.deepseek-cli/credentials.json plaintext с правами 0600 на Unix / ACL юзера на Windows.

В будущем, когда сессия истечёт и понадобится re-login, программа сама заполнит форму и кликнет Sign in. Тебе остаётся только пройти captcha, если попросят.

Если входишь через Google OAuth — эта команда не нужна. Google-форма не наша, autofill там не сработает, но Google-сессия и так сохранится в Chromium-профиле и при следующем re-login потребует от тебя только клик на «Sign in».

В окне чата справа сверху — кнопка ⚙. Открывается панель с тремя группами команд по уровню риска:

• 🟢 Low: node, npm, python, ls, cat, mkdir, cp, grep, и т.п. — безопасны.
• 🟡 Medium: git, mv, sed, chmod, make, find — могут менять данные, но с защитами (например, git clone и push --force заблокированы).
• 🔴 High: rm — со строгой блокировкой -rf.

Чекбокс = включено для /code. Сохраняется мгновенно. По умолчанию включены первые 7 команд (старый whitelist).

В UI окна:

1. Кнопка «+ New chat» → модалка.
2. Поле «Папка проекта» — путь к workspace. Под полем: чипы недавних проектов.
3. Кнопка 📁 Обзор — открывает файловый браузер. Можно ходить по дереву, создавать новые папки прямо там через ➕ Новая папка.
4. Чекбокс «Создать папку, если её ещё нет» — если включён, программа создаст путь из инпута (только под $HOME).
5. Создать чат → чат привязан к этой папке. Любой /code в этом чате работает с файлами в его папке, не пересекаясь с другими.

В сайдбаре под именем чата видно 📁 имя-папки — это его workspace.

Ctrl+C в терминале → сервер останавливается → окно чатов через ~4–6 секунд само закрывается (heartbeat polling в фронте определяет, что сервер мёртв).

Закрытие терминала через ⌘W / правый-клик-Close — то же самое (терминал шлёт SIGHUP).

Если что-то зависло, можно убить процесс по PID. На Windows — Task Manager → Node.js.

• Открывает окно чатов в --app= режиме Chrome (без табов, без URL-бара, выглядит как desktop-приложение).
• При первом запуске Chrome macOS может спросить «Chrome wants to access Documents folder» — разреши.
• SIGINT/SIGHUP работают штатно. Окно закрывается само через ~5с после Ctrl+C.

• Окно чатов открывается в --app= режиме: программа ищет google-chrome, chromium, chromium-browser или microsoft-edge в PATH и запускает с флагом --app=URL. Получаешь отдельное окно-приложение, как на macOS.
• Если ни один из этих браузеров не установлен — fallback на xdg-open: обычная вкладка в дефолтном браузере.
• Если у тебя Wayland (а не X11), Chromium из Playwright обычно работает, но если возникнут странности — попробуй XDG_SESSION_TYPE=x11 npm start.
• Системные зависимости для Playwright Chromium ставятся командой sudo npx playwright install-deps chromium.

• Окно чатов открывается в --app= режиме: программа ищет chrome.exe в стандартных местах (Program Files\Google\Chrome\Application\, %LOCALAPPDATA%\Google\Chrome\Application\), также пробует msedge.exe от Edge.
• Если ничего не найдено — fallback на cmd /c start (открывает в дефолтном браузере как обычную вкладку).
• Маскированный ввод пароля (npm run save-creds) работает в Windows Terminal и PowerShell. В классическом CMD тоже работает, но без UTF-8 в кириллице могут быть кракозябры в выводе.
• Ctrl+C ловится штатно. SIGHUP на Windows не существует — но при закрытии окна терминала Node всё равно умирает, фронт это замечает по heartbeat и закрывается.
• fs.chmodSync(0o600) — no-op (Windows использует ACL). По умолчанию папка %USERPROFILE%\.deepseek-cli\ доступна только владельцу.

Правило №1: rm -rf ~/.deepseek-cli && npm start (или Remove-Item -Recurse -Force $env:USERPROFILE\.deepseek-cli на Windows). Это ядерный сброс — снесёт сессию, токены, профиль, настройки. После сброса заново заходишь, всё работает с нуля.

Error: Executable doesn't exist at ...chromium... → не запускал npx playwright install chromium. Запусти.

Failed to create a ProcessSingleton → остался stale lock от падающего Chromium. Запусти ещё раз — программа сама чистит эти файлы при следующем launch.

Окно открылось, но chat.deepseek.com показывает ошибки → попробуй обновить страницу. Если не помогло — ядерный сброс.

Сессия истекла, окно re-login не открывается → npm run login (DeepSeek) или npm run login-qwen (Qwen).

Распознавание картинок (vision): invalid ref file id (biz_code 9) → completion раньше, чем файл стал SUCCESS. В логах нужно ready (status=SUCCESS), не PARSING.

CONTENT_EMPTY после upload → DeepSeek не смог разобрать картинку (не «долго грузится»). Сразу ошибка с подсказкой. Что попробовать: JPG/PNG (не SVG), до ~4 МБ, чёткий скриншот/фото с текстом. Большие PNG (~1.5 МБ) иногда дают CONTENT_EMPTY — сожми или пересохрани в JPEG.

Ядерный сброс только Qwen (DeepSeek не трогает):

rm -rf ~/.qwen-cli
npm run login-qwen

Этот проект можно использовать как провайдер для Kilo Code или других IDE с поддержкой OpenAI-совместимых API.

npm run api

Сервер запустится на http://127.0.0.1:4318.

1. Подключи провайдеров в CLI: npm run login и/или npm run login-qwen
2. Запусти API: npm run api или открой окно чатов и возьми Base URL из Settings
3. В Kilo Code — OpenAI-совместимый провайдер:
   • Base URL: http://127.0.0.1:4318/v1
   • API Key: DeepSeek или Qwen key из Settings
   • Модели: см. GET http://127.0.0.1:4318/v1/models

Важно: в настройках Kilo указывай именно эти id — не подставляй deepseek-reasoner вручную в другие поля. Сервер сам маппит deepseek-reasoner → model_type: expert у DeepSeek.

При ошибке unknown variant 'deepseek-reasoner' — обнови репозиторий (git pull) и перезапусти node api/server.mjs (нужна актуальная api/models.mjs).

PyCharm AI Assistant запускает ACP-агента как subprocess из ~/.jetbrains/acp.json. Для этого в проекте есть режим:

node ./bin/deepseek.mjs --acp

ACP-агент ходит в наш OpenAI-compatible API (http://127.0.0.1:4317/v1 или 4318/v1). Перед запуском в PyCharm должен быть поднят npm start или npm run api.

Пример ~/.jetbrains/acp.json:

{
  "default_mcp_settings": {
    "use_idea_mcp": true,
    "use_custom_mcp": true
  },
  "agent_servers": {
    "HR Recruiter (Qwen)": {
      "command": "/path/to/node",
      "args": ["/path/to/ai-free/bin/deepseek.mjs", "--acp"],
      "env": {
        "OPENAI_BASE_URL": "http://127.0.0.1:4317/v1",
        "OPENAI_API_KEY": "QWEN_KEY_FROM_SETTINGS",
        "OPENAI_MODEL": "qwen3.7-max",
        "DSCLI_ACP_ROLE": "recruiter"
      }
    }
  }
}

Доступные HR-роли: recruiter, sourcer, interviewer, policy.

• Токены и cookies — в ~/.deepseek-cli/ и ~/.qwen-cli/ (plaintext, 0o600 на Unix, ACL на Windows).
• credentials.json — только DeepSeek, опционально. Не используй тот же пароль, что для банка/почты.
• /code — команды без shell, в пределах workspace, whitelist. curl/wget/bash заблокированы по умолчанию.
• Серверы чатов и API слушают только 127.0.0.1 (4317, 4318).
• Chromium-профили DeepSeek и Qwen разделены — сессии не смешиваются; открывает только Playwright по запросу программы.

Нашёл баг или есть идея? Открой Issue — отвечу.

Personal-Use-Only — см. LICENSE. Кратко: использовать в личных целях можно, распространять и модифицировать для распространения — только с разрешения автора. При любом одобренном использовании имя автора должно сохраняться.