verdent

KO | EN

gitlite — search

#kubernetes #computer-vision #open-source #postgresql #ai-agent #privacy #reactjs #java #docker #awesome-list

(★ 9)

No description available.

File Explorer

ZIP Download

- accounts.js
- config.js
- conversations.js
- crypto.js
- dashboard.js
- handlers.js
- health.js
- keychain-adapter.js
- keychain.js
- oauth.js
- server.js
- translate.js
- upstream.js
- util.js
.gitignore
package.json
README.md
router.mjs
verdent-system.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Локальный прокси для бесплатных моделей Verdent. Отдаёт OpenAI-совместимый и Anthropic-совместимый API на `127.0.0.1:8320`.

Без зависимостей. Нужен только Node.js 18+.

## Установка

```sh
git clone https://github.com/spflw/verdent.git
cd verdent
```

Больше ничего ставить не надо.

## Запуск

```sh
node router.mjs
```

Поднимется сервер на `http://127.0.0.1:8320`. Дашборд — в браузере на `http://127.0.0.1:8320/`.

При первом запуске на macOS токен подтянется из Keychain автоматически (если Verdent.app залогинен). Либо добавь аккаунты вручную:

- **OAuth** — кнопка «OAuth login» в дашборде, откроется браузер.
- **Токен** — вставь JWT в поле «paste access token» и нажми «Add token».

Несколько аккаунтов работают в режиме round-robin (галочка в дашборде) или один активный.

## Как пользоваться

Любой клиент с OpenAI-совместимым API — укажи base URL:

```
http://127.0.0.1:8320/v1
```

Эндпоинты:

```
GET  /v1/models
POST /v1/chat/completions    (OpenAI-формат)
POST /v1/messages            (Anthropic-формат)
GET  /health
```

Пример:

```sh
curl http://127.0.0.1:8320/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"glm-5.3-flash-free","messages":[{"role":"user","content":"привет"}]}'
```

Модели по умолчанию: `glm-5.3-flash-free`, `deepseek-v4-flash-free`. Если одна упёрлась в лимит, роутер сам пробует следующую.

## Настройки через переменные окружения

| Переменная | По умолчанию | Зачем |
|---|---|---|
| `LISTEN_PORT` | `8320` | Порт |
| `LISTEN_HOST` | `127.0.0.1` | Адрес; `0.0.0.0` — доступ из сети (тогда задай `PROXY_TOKEN`) |
| `PROXY_TOKEN` | пусто | Если задан — все запросы требуют `Authorization: Bearer <token>` |
| `FREE_MODELS` | `glm-5.3-flash-free,deepseek-v4-flash-free` | Список моделей через запятую, порядок = порядок fallback |
| `ROUTER_DATA_DIR` | `~/.verdent-free-router` | Папка с данными (аккаунты, история) |

Пример:

```sh
PROXY_TOKEN=secret LISTEN_PORT=9000 node router.mjs
```

## Память диалогов

По умолчанию историю клиент шлёт сам (opencode, cursor и т.п. так и делают). Если клиент шлёт только последнее сообщение — добавь в запрос:

```json
{"conversation_id": "my-chat-1", ...}
```

Роутер будет хранить контекст на своей стороне (до 200 сообщений на диалог).

## Данные и обновление

Аккаунты и история лежат в `~/.verdent-free-router/` — вне репозитория. Обновление кода их не трогает:

```sh
git pull
# перезапустить роутер
```

verdent

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README