DeepSeek, Qwen 및 ChatGPT를 위한 로컬 AI 클라이언트 (API, 코드 에이전트, 메모리 및 스킬 지원)

Local AI client for DeepSeek, Qwen and ChatGPT with API, code agent, memory and skills

AI Free는 무료 AI 웹 채팅을 로컬 개발자 도구로 변환합니다.

하나의 데스크톱 창에서 DeepSeek, Qwen, ChatGPT를 사용하고, CLI(Command Line Interface), 호환 API, IDE 통합 및 코드 에이전트 워크플로우를 통해 로컬 메모리, 스킬 및 작업 공간 인식 채팅 기능을 활용할 수 있습니다.

다음과 같은 사용자에게 유용합니다:

• 무료 로컬 AI 코딩 어시스턴트를 원하는 개발자;
• 웹 AI 채팅을 사용하지만 API/CLI 접근이 필요한 사람;
• 에이전트, 메모리, 스킬 및 IDE 자동화 실험을 진행하는 사용자.

AI Free는 무료 웹 AI 채팅을 실용적인 코딩 어시스턴트로 활용하기 위한 오픈 소스 로컬 AI 클라이언트이자 개발자 도구입니다. 이 도구는 DeepSeek, Qwen, ChatGPT를 데스크톱 앱, 커맨드 라인 인터페이스(CLI), 로컬 OpenAI 호환 API, Anthropic 호환 API, VS Code 플러그인, 메모리, 스킬 및 작업 공간 인식 코드 에이전트 워크플로우에 연결합니다.

사람들은 보통 이 프로젝트를 무료 AI 코딩 어시스턴트, 로컬 AI 클라이언트, Qwen 또는 DeepSeek용 OpenAI 호환 API, ChatGPT 데스크톱 클라이언트, Qwen VS Code 확장 프로그램, DeepSeek 코드 에이전트, AI 개발 도구의 무료 대안, 또는 메모리와 스킬을 갖춘 로컬 에이전트로 찾습니다.

• 하나의 로컬 데스크톱 앱에서 Qwen, DeepSeek 및 ChatGPT를 실행합니다.
• OpenAI 호환 API 엔드포인트를 통해 Qwen 또는 DeepSeek을 사용합니다.
• 로컬 AI 채팅을 VS Code, Continue, Kilo Code 등 다른 개발자 도구에 연결합니다.
• 코드 에이전트에게 제어된 명령어 권한으로 프로젝트 폴더를 읽고 편집하도록 요청할 수 있습니다.
• 반복적인 개발 작업을 위해 로컬 메모리, 스킬 및 재사용 가능한 워크플로우를 유지합니다.
• 무료 웹 AI 제공업체를 중심으로 에이전트 파이프라인, Telegram 워크플로우 및 브라우저 자동화를 구축합니다.

하나의 로컬 앱: 하나의 작업 공간에서 DeepSeek, Qwen 및 ChatGPT 채팅을 지원합니다.개발자 인터페이스: 데스크톱 UI, CLI, OpenAI 호환 API 및 Anthropic 호환 API를 제공합니다.코드 에이전트: /code

작업 공간 파일 접근 및 제어된 명령어 권한을 가진 코드 에이전트 모드 지원. 메모리 및 스킬: 장기 메모리, 메모리 그래프 및 재사용 가능한 작업 워크플로우를 제공합니다. 프로젝트 지침: 계층적 AGENTS.md 파일을 사용하며, 모든 코드 에이전트 작업 전에 파일들이 다시 로드됩니다. 중첩된 파일은 자체 디렉토리 트리에 적용됩니다. IDE 친화적: Continue, Kilo Code 및 PyCharm ACP와 호환되는 플로우 같은 도구들과 연동됩니다. 로컬 우선 세션: 제공업체 브라우저 세션과 앱 상태가 사용자의 기기에 저장됩니다.

AI Free 0.4.25

DeepSeek, Qwen 및 ChatGPT 웹 채팅을 개발자 도구(채팅 창, CLI, 호환 API, /code 에이전트, 메모리, 스킬 및 IDE 통합)로 변환하는 로컬 AI 클라이언트입니다.

AI Free가 시간을 절약해 주었다면 GitHub에 별점을 남겨주세요. 이는 프로젝트를 검색과 추천 목록에 노출시키는 데 도움이 됩니다.

물질적인 감사를 표하고 싶다면 어떤 금액이라도 이 프로젝트가 의미가 있고 새로운 기능을 추가할 동기 부여가 된다는 신호를 줍니다 (다중 제공업체 Qwen/Kimi, 첨부 파일, 응답 스트리밍 등).

카드 (OTP 은행): 2201 9604 2500 7505

감사합니다!

아키텍처적으로 프로젝트는 src/ 내의 모듈들(auth, browser, providers, code-agent, memory, skills, agent-orchestrator, state, window-app, api, cli)로 분리되어 있습니다. 진입점은 bin/deepseek.mjs입니다.

유닛 테스트는 내장된 Node test runner에서 npm test 명령어로 실행되며, 정확한 횟수는 현재 버전에 따라 다릅니다. 메모리와 스킬의 아키텍처는 docs/AI_FREE_BRAINS_AND_SKILLS_PLAN.md에 있습니다. 비디오 시나리오는 docs/VIDEO_SCRIPT.md에 있습니다.

• 💬 세 가지 제공업체: DeepSeek, Qwen 및 ChatGPT를 하나의 창에서 사용할 수 있으며, 대화 생성 시 모델을 선택할 수 있습니다. - 🔑 DeepSeek 자동 로그인: 브라우저를 통해 한 번만 로그인하면 세션 복원 또는 재로그인 창이 자동으로 이루어집니다. - 🔐 Qwen 및 ChatGPT 자동 로그인: 각 제공업체별로 별도의 프로필과 로컬 세션을 가집니다. - 🪟 채팅 창(localhost:4317)

여러 개의 병렬 대화가 가능하며, 각 대화는 자체 폴더-프로젝트에 연결됩니다. - ⌨️
CLI 모드: 터미널에서 스크립트 시나리오 및 빠른 질문을 위한 REPL(Read-Eval-Print Loop) 기능. - 🛠️
워크스페이스 파일 접근 및 허용된 명령어(/code) 사용.

에이전트: 🧠 메모리 (Memory): 에이전트의 장기 기억 — SQLite FTS5 + Markdown 볼트 (~/.ai-free/memory/). 상단바에서 전환 가능하며, 설정(Settings) → 에이전트(Agent)에서 확인 가능. 프로젝트 규칙은 매번 에이전트 작업 전에 로드됩니다. 루트 파일은 전체 워크스페이스에 적용되며, 하위 폴더의 파일은 해당 디렉토리 및 그 하위 카탈로그에 적용되고 상위 파일보다 우선합니다. AGENTS.md

:🔗 메모리 그래프 (Memory graph): task ↔ file ↔ bug ↔ fix 간의 연결; 반복적인 작업 시 컨텍스트를 확장합니다. ⚡ 스킬 (Skills): 내장된 code-review, bug-fix, video-script 등.
; 작업에 따라 자동 매칭됩니다: /skill <id> <task>

.Agent orchestrator: /code 전에 최신 AGENTS.md, 메모리, 스킬을 시스템 프롬프트(system prompt)에 수집합니다. - 🔌
호환 API (Compatible API) (localhost:4318):
Kilo Code, Continue 및 기타 IDE를 위한 OpenAI와 Anthropic 지원. - 🎙️
음성 입력: Parakeet V3는 첫 사용 시 별도로 다운로드됩니다. - 📁
파일 브라우저: 채팅을 생성할 때 폴더를 선택하거나 새 폴더를 만들 수 있습니다.

현재 릴리스 버전은 데스크톱/CLI/API, VS Code 확장 및 PyCharm 플러그인으로 AI Free 0.4.25입니다.

0.4.25에 포함된 내용
: 릴리즈 노트(release notes).

모든 곳에서 필요합니다:

Node.js ≥ 18(nodejs.org). 확인 방법: node -v
.npm(Node와 함께 제공됨).- 인터넷 연결 및 Chromium 설치 (~150MB).

선택 사항:

**Google Chrome.**설치되어 있는 경우, 프로그램은 이를 '진짜' 브라우저(최신 버전이며 모든 보안 업데이트가 적용된)로 사용합니다. 없는 경우, Playwright의 Chromium이 자동으로 다운로드됩니다.

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

npm install은 postinstall 훅을 통해 Chromium (~150MB)를 자체적으로 다운로드하므로, 별도의 명령어가 필요하지 않습니다.

만약 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도 되지만, 대화형 입력(예: npm run save-creds 시)에는 Windows Terminal이 더 편리합니다.

npm start

무슨 일이 일어날까요:

• 아직 어떤 제공업체도 연결되지 않은 경우 — 콘솔에 환영 화면이 나타납니다: 1(DeepSeek), 2(Qwen) 또는 1, 2(둘 다)를 선택합니다. - 선택된 각 제공업체에 대해 Chrome/Chromium 로그인 창이 열립니다 — 한 번만 접속하면 됩니다(Google OAuth, 이메일/비밀번호, 캡차). DeepSeek: 첫 번째 성공적인 API 요청 후 창은 자동으로 닫힙니다; 세션은 ~/.deepseek-cli/에 저장됩니다.

.Qwen: 쿠키에 JWT(token)가 나타날 때 창이 닫힙니다; 세션은 ~/.qwen-cli/에 저장됩니다.

.- 채팅 작업 창( localhost:4317 )이 열립니다.

재실행 — 인증 정보가 이미 있는 경우 환영 화면 없이 npm start를 실행합니다. Qwen은 나중에 추가할 수 있습니다: «+ New chat» → Qwen → «클릭하여 연결».

관리 파일들은 프로젝트 외부, 사용자 홈 폴더에 위치합니다.

DeepSeek (~/.deepseek-cli/ (Unix의 경우), %USERPROFILE%\.deepseek-cli\ (Windows의 경우)):

~/.deepseek-cli/
├── auth.json # cookies + userToken (Unix에서 mode 0600)
├── browser-profile/ # DeepSeek 세션이 포함된 Chromium 프로필
...

Qwen (DeepSeek과 분리되어, 혼합되지 않음):

~/.qwen-cli/
├── auth.json # cookies + JWT token
└── browser-profile/ # chat.qwen.ai 및 browser-proxy용 Chromium 프로필

ChatGPT (DeepSeek 및 Qwen과 분리됨):

~/.chatgpt-cli/
├── auth.json # cookies + 세션 데이터
└── browser-profile/ # chatgpt.com용 Chromium 프로필

Memory + Skills (모든 제공업체에 공통):

~/.ai-free/
├── memory/
│ ├── memory.db # SQLite FTS5 (+ graph tables)
...

채팅 및 설정 /code는 ~/.deepseek-cli/state.json에 있습니다 (모든 제공업체에 공통).

삭제 수준이 두 가지가 있습니다:

애플리케이션 코드만 삭제— 채팅, 토큰, 브라우저 세션, 메모리 및 스킬은 홈 폴더에 남아 있습니다.완전히 삭제— 채팅, 인증 정보, 로컬 메모리, 스킬, 브라우저 프로필 및 VS Code 플러그인과 함께 합니다.AI Free가 git clone을 통해 설치된 경우

애플리케이션을 닫고 프로젝트 폴더를 삭제하세요:

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

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

~/path/to/ai-free 또는 $env:USERPROFILE extbackslash path extbackslash to extbackslash ai-free를 실제 클론된 프로젝트 경로로 대체하세요.

이 명령어는 다음을 삭제합니다:

• 채팅 및 설정:
  ~/.deepseek-cli/state.json, settings.json
  ; - DeepSeek 세션 및 브라우저 프로필:
  ~/.deepseek-cli/
  ; - Qwen 세션 및 브라우저 프로필:
  ~/.qwen-cli/
  ; - ChatGPT 세션 및 브라우저 프로필:
  ~/.chatgpt-cli/
  ; - 메모리, 스킬 및 설치된 AI Free 플러그인:
  ~/.ai-free/
  .

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

# Windows PowerShell
Remove-Item -Recurse -Force `
"$env:USERPROFILE	extbackslash .deepseek-cli", `
... 

이후 이전 항목과 같이 프로젝트 폴더 자체를 삭제하세요.

VS Code 인터페이스를 통해:

• **확장(Extensions)**을 엽니다. - AI Free Chat & Agent를 찾습니다. - **제거(Uninstall)**를 누릅니다. - VS Code를 다시 시작합니다.

터미널을 통해:

code --uninstall-extension developers-daily-life.ai-free-vscode

만약 code 명령어가 사용 불가능하다면, 명령 팔레트(Command Palette) → Shell Command: Install 'code' command in PATH를 통해 VS Code에 활성화하세요.

플러그인 자체는 데스크톱 버전과 동일한 로컬 데이터를 사용합니다. 흔적 없이 모든 것을 삭제하려면, 확장 프로그램을 제거한 후 데스크톱/로컬 버전 및 데이터 전체 삭제 섹션의 명령어를 실행하세요.

AI Free는 npm 의존성을 통해 Chromium을 다운로드합니다. 일반적으로 프로젝트 폴더와 node_modules를 삭제하는 것으로 충분하지만, 공간을 완전히 확보하려면 브라우저 캐시도 삭제할 수 있습니다:

# macOS / Linux
rm -rf ~/Library/Caches/ms-playwright ~/.cache/ms-playwright ~/.cache/patchright

만약 이 폴더들에 Playwright의 다른 프로젝트에서 사용하던 브라우저가 들어있다면, 그것들도 삭제되며 다음 번 해당 프로젝트를 실행할 때 다시 다운로드될 수 있습니다.

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를 사용합니다 (chat.qwen.ai 측에서 bx-ua 서명). 로그인 없이는 채팅에서 Qwen이 나타나지 않습니다.

npm start

«+ 새 채팅» → 제공업체 Qwen - '클릭하여 연결' 서명이 있는 경우 Qwen 카드를 클릭합니다.

• 대화 확인 → 열립니다.
  chat.qwen.ai

→ 로그인 → 창이 자동으로 닫힙니다.

npm run login-qwen

• 일반 Chrome에서 chat.qwen.ai에 로그인한 후, 확장 프로그램(Cookie Editor, EditThisCookie)을 사용하여 쿠키를 JSON 형식으로 내보냅니다.
• 가져오기:

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

쿠키는 auth.json과 browser-profile 모두에 저장됩니다.
— API와 채팅 창이 동일한 세션을 인식하게 됩니다.

DeepSeek의 경우처럼: 세션이 만료되면 프로그램은 먼저 ~/.qwen-cli/browser-profile에서 **조용한 새로고침(silent refresh)**을 시도합니다 (창 없이). 실패하면 로그인 창을 엽니다. 이 기능은 채팅 창과 API (node api/server.mjs) 모두에 내장되어 있습니다.

Qwen 채팅을 사용하려면 최소한 한 번의 성공적인 login-qwen 또는 가져오기가 필요합니다. 그렇지 않으면 업데이트할 내용이 없습니다.

일반 이메일 로그인(Google OAuth가 아닌 경우)을 사용하고 완전 자동화를 원한다면:

npm run save-creds