convez.ai
AgenteIntegração & APIsAvançado
youssefvdel

Qwen Gate

youssefvdel/qwen-gate

API gateway gratuito para Qwen em clientes OpenAI-compatíveis

Ver no GitHub
BomPluginScore · de 0 a 100

Gateway OpenAI-compatível para modelos Qwen. Transforma sua conta Qwen (chat.qwen.ai) em um provedor de API de IA gratuito, funcionando com qualquer cliente compatível com OpenAI — Cursor, Continue.dev, Claude Code, VS Code Copilot ou agentes de código. Auto-hospedado com autenticação baseada em Chromium, suporte a streaming e chamada de funções.

Instalação

$npx convez-ai youssefvdel/qwen-gate

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
219
Forks
48
Acompanhando
9
Saúde
71%
Último commit
há 3 meses
Versão
v0.8.0
Issues abertas
15
Contribuidores
1

Casos de uso

  • Usar modelos Qwen gratuitamente em editores como Cursor e VS Code
  • Integrar Qwen como alternativa sem custos em agentes de código
  • Distribuir requisições entre múltiplas contas Qwen com failover automático

Veredito

Solução técnica sólida para quem quer usar Qwen como API gratuita. Requer conhecimento de DevOps e navegação em limites legais de termos de serviço — não é recomendado para produção crítica sem alertas claros.

README

A tradução para o português deste README ainda está na fila.

Qwen Gate

License: MIT Bun GitHub Release TypeScript Playwright

Disclaimer: This project is for educational and study purposes. It provides access to Qwen models via chat.qwen.ai browser automation. Not affiliated with Alibaba Group or Qwen. Users must comply with chat.qwen.ai's terms of service.


Quick Start

curl -sSL https://raw.githubusercontent.com/youssefvdel/qwen-gate/main/install.sh | bash
cd qwen-gate
qg

Then open http://localhost:26405/dashboard to add accounts and start using the API.

Features

  • Free Qwen Models — Use Qwen 3.7-Max, Qwen 3-Max, Qwen 3-Plus, and more for free in your existing tools. Point Claude Code, OpenCode, Qwen Code, Cursor, or any OpenAI-compatible client at Qwen Gate and use Qwen models without paying per-token.
  • OpenAI-Compatible API — Drop-in replacement for /v1/chat/completions and /v1/models. Works with existing OpenAI SDKs, curl, or any HTTP client.
  • Multi-Account Rotation — Configure multiple Qwen accounts (3+ recommended). Requests are distributed via round-robin with automatic failover and cooldown tracking — cooldown limits become a non-issue.
  • Session Pooling — Browser sessions are pooled, reused, and autoscaled under load. No per-request login overhead.
  • Tool Calling — Full OpenAI-style function calling with JSON Schema validation and spam guards.
  • Streaming SSE — Server-Sent Events with heartbeat keep-alive and content filter integrity maintained across stream boundaries.
  • Content Filter Pipeline — Strips thinking tags and filters internal artifacts from model output.
  • Web Dashboard — Real-time monitoring with 5 pages: overview, request log, account manager, network debug, and settings.
  • Stealth Browser Automation — Uses CloakBrowser with anti-detection patches to maintain session integrity.
  • No Build Step — TypeScript executed directly via Bun. Run from source with no compilation needed.
  • Bun-Powered — Native TypeScript execution, built-in test runner, and cluster mode for multi-core utilization.

Installation

One-Command Install (Linux / macOS)

curl -sSL https://raw.githubusercontent.com/youssefvdel/qwen-gate/main/install.sh | bash

This clones the repo, installs dependencies, creates config.json, and symlinks the qg / qwengate / qwen-gate CLI commands.

Windows Install

Open PowerShell (as administrator) and run:

powershell -ExecutionPolicy Bypass -c "curl.exe -sSL https://raw.githubusercontent.com/youssefvdel/qwen-gate/main/install.ps1 | iex"

Or clone manually:

git clone https://github.com/youssefvdel/qwen-gate.git
cd qwen-gate
bun install

Then run qg to start the server.

Manual Install

git clone https://github.com/youssefvdel/qwen-gate.git
cd qwen-gate
bun install

Start the Server

qg

Or:

bun start

The server starts on http://localhost:26405.

Add Accounts

⚠️ Best practice: Use 3+ accounts for round-robin rotation to bypass cooldown limits. Do not use your personal Qwen account — create dedicated accounts.

  1. Open http://localhost:26405/dashboard/accounts
  2. Enter your Qwen email and password
  3. Click Add Account — the gateway handles login and session persistence

Usage

Use with Any OpenAI-Compatible Client

Qwen Gate works with any tool that speaks OpenAI's API: Claude Code, OpenCode, Qwen Code, Cursor, standard OpenAI SDKs (Python, Node.js, curl), and anything else using the /v1/chat/completions format — just point it at http://localhost:26405/v1.

Tip: Use model: "qwen3-7-max" for the latest Qwen model. Available models: qwen3-7-max, qwen3-6-plus, qwen3-max, qwen3-coder, qwen3-5-plus, qwen3-5-flash, and more.

Chat Completion

curl -X POST http://localhost:26405/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "qwen3-max",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Streaming

Set "stream": true for SSE:

curl -X POST http://localhost:26405/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{"model": "qwen3-max", "stream": true, "messages": [{"role": "user", "content": "Count to 5"}]}'

Tool Calling

How it works: Qwen doesn't natively support tool calling — it outputs tool calls as JSON text in its response. The gateway parses that text and converts it into OpenAI-compatible tool call objects. It's not perfect, but it works for most use cases.

curl -X POST http://localhost:26405/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "qwen3-max",
    "messages": [{"role": "user", "content": "Weather in Paris?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }]
  }'

Configuration

All settings in config.json. Key options:

KeyDefaultDescription
PORT"26405"Server port
API_KEY""Bearer token for API auth (empty = no auth)
BROWSER"chromium"Browser engine: chromium, firefox, webkit, chrome, edge
TOOL_CALLING"true"Enable tool call parsing
CLEAN_OUTPUT"true"Strip internal artifacts from responses
STREAMING_MODE"auto"Streaming mode: auto, on, off
SAVE_REQUEST_LOGS"false"Save per-request logs to disk
OPEN_DASHBOARD_ON_START"false"Auto-open dashboard in browser
RATE_LIMIT_COOLDOWN_MS"120000"Cooldown after rate limit (2 min)
RETRY_MAX_ATTEMPTS"3"Max retry attempts

Note: This is a partial list of 10 commonly-used keys. See ConfigSchema in src/services/configService.ts for the full list.

Architecture

Web Dashboard

Accessible at http://localhost:26405/dashboard.

PagePathPurpose
Overview/dashboardKPIs, model health, system logs, session pool status
Logs/dashboard/logsReal-time request log with expandable entry details
Accounts/dashboard/accountsAdd/remove Qwen accounts, view auth status
Network/dashboard/networkOutbound API call inspector
Settings/dashboard/settingsLive config editor (changes apply instantly)

CLI

Three binary aliases: qg, qwengate, qwen-gate.

Usage: qg [command] [options]

Commands:
  start          Start the API server (default)
  update         Pull latest code and reinstall dependencies
  restart        Restart the running server
  status         Check if the server is running
  help           Show help message

Options:
  --port <n>     Override port
  --browser <e>  Browser engine: chromium, firefox, webkit, chrome, edge
  --host <addr>  Bind address

Account management is done via the web dashboard → Accounts page.

Updating

Via CLI (easiest)

qg update

This runs git pull --ff-only && bun install. Then restart the server:

qg restart

Manual

git pull && bun install && qg restart

Re-run the installer

# Linux / macOS
curl -sSL https://raw.githubusercontent.com/youssefvdel/qwen-gate/main/install.sh | bash

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -c "curl.exe -sSL https://raw.githubusercontent.com/youssefvdel/qwen-gate/main/install.ps1 | iex"

The server checks for new GitHub releases on startup and logs a warning in the dashboard when an update is available.

Project Structure

src/
├── cli.ts                   CLI entry (qg command parser)
├── cluster.ts               Multi-core cluster mode
├── index.tsx                Hono server, routing, CORS, auth
├── models.json              Model definitions (context lengths, modalities)
├── routes/                  API route handlers
│   ├── chat.ts              Chat completions dispatch
│   ├── chatHelpers.ts       Chat request orchestration helpers
│   ├── chatStreaming.ts     Streaming SSE logic
│   ├── chatNonStreaming.ts  Non-streaming responses
│   ├── chatHelpersCore.ts   Core chat response handling
│   ├── chatStreamingHelpers.ts Streaming helper utilities
│   ├── cleanupHelpers.ts    Cleanup logic
│   ├── compressToolResult.ts Tool result compression
│   ├── streamLoop.ts        Streaming loop with idle timeout
│   ├── writeHelpers.ts      Write helper utilities
│   ├── accounts.ts          Account CRUD API
│   ├── config.ts            Config read/write API
│   └── dashboard/           Web dashboard (vanilla HTML/JS)
│       ├── accounts.ts      Account management page
│       ├── dashboardRoutes.ts  Dashboard routing hub
│       ├── logs.ts          Request log page
│       ├── monitor.ts       Real-time monitoring page
│       ├── network.ts       Network debug page
│       ├── overview.ts      Dashboard overview/KPI page
│       ├── settings.ts      Settings page
│       ├── sidebar.ts       Sidebar navigation
│       └── public/          Static dashboard assets (JS/CSS/SVG)
├── services/                Business logic
│   ├── accountManager.ts    Account CRUD, round-robin rotation
│   ├── auth.ts              Auth orchestration
│   ├── browserProfiles.ts   Browser profile management
│   ├── configService.ts     Config loader
│   ├── defaultSystemPrompt.ts Default system prompt
│   ├── logStore.ts          In-memory log store + SSE
│   ├── loginHelpers.ts      Login helper utilities
│   ├── modelHealth.ts       Model health tracking
│   ├── modelRouter.ts       Model routing & fallback
│   ├── monitorStore.ts      Monitoring data store
│   ├── networkDebug.ts      Outbound call capture
│   ├── playwright.ts        Browser init & management
│   ├── qwen.ts              Qwen API interaction
│   ├── qwenFileUpload.ts    Qwen file upload handling
│   ├── qwenLogger.ts        Qwen-specific logging
│   ├── qwenModels.ts        Model fetching & mapping
│   ├── sessionPool.ts       Session pool with autoscaling
│   ├── systemLogger.ts      System-wide logger
│   └── tokenRefresh.ts      Token refresh logic
├── tools/                   Tool calling system
│   ├── registry.ts          Tool registry
│   ├── xmlToolParser.ts     XML tool call parsing
│   ├── guard.ts             Spam/abuse guard
│   ├── schema.ts            JSON Schema validation
│   └── schemaValidators.ts  Schema validation helpers
├── utils/                   Shared utilities
│   ├── auth.ts              Auth utilities
│   ├── contentFilter.ts     Streaming content filter
│   ├── paths.ts             Path utilities
│   ├── retry.ts             Exponential backoff
│   ├── tagNames.ts          Centralized tag names
│   ├── thinkTagStripper.ts  Think tag stripping
│   ├── tokenEstimator.ts    Token estimation
│   ├── version.ts           Version information
│   ├── xmlStripper.ts       XML/tool call artifact removal
│   └── xmlStripper.test.ts  XML stripper tests
├── tests/                   Integration tests
├── types/                   TypeScript interfaces
└── middleware/
    └── rateLimit.ts         Token bucket rate limiter

Testing

bun test

Uses Bun's built-in test runner. Covers content filtering, tool-call parsing, and streaming sanitization.

Documentation

DocumentDescription
ArchitectureSystem design, component breakdown, data flow
API ReferenceFull endpoint documentation
DeploymentProduction deployment guide
DevelopmentContributing, testing, code conventions

Star History

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados