aipass-bridge README

The project's README from github.com/niawjunior/aipass-bridge. As one markdown file: README.md.

aipass bridge

aipass bridge

Make AiPASS great again — now with a terminal.

AiPASS gives every Thai citizen free access to 30+ pro AI models. It only speaks one language though: a chat box. This puts it in your terminal, your editor, and any OpenAI-compatible tool — and lets it read and write your local files.

test

What it does

your terminal ──▶ OpenAI-compatible API on localhost:8787 ──▶ a real logged-in AiPASS tab

No credential ever leaves your browser. The real request runs as ordinary page JavaScript inside your own logged-in tab, so Chrome attaches the session cookie itself. The bridge never sees it, and nothing is written to disk.

Quick start

npm run dev

Then load the extension — chrome://extensions → Developer mode → Load unpacked → select aipass-bridge/extension — and open a de.aipass.net/chat tab. The extension popup should read Connected.

npm run doctor                                     # is every link working?
npm run setup-assistant                            # one-time: the agent's assistant
npm run chat -- "ช่วยสรุปข่าว AI วันนี้"         # chat, streaming
npm run chat -- "แมวน่ารัก" --model gpt-image-2   # generate an image
npm run chat -- "summarise this" --file report.pdf # ask about a document
npm run chat -- "a street at night" --model seedance-2.0-mini  # generate a video
npm run agent -- "add a /health route" --root .    # edit local files (dry run)
npm run models                                     # everything, by category
npm run credits                                    # what is left of the pool

Note the -- before a script's own flags: npm run chat --new is npm's flag, npm run chat -- --new is the script's. Every command takes -- --help.

If something is not working, npm run doctor walks the chain and names the one thing to fix:

✓ bridge         responding
✗ extension      no tab attached
                 → open https://de.aipass.net/chat and leave it open
– login          skipped — nothing attached to ask

Use it from code like any OpenAI endpoint:

from openai import OpenAI
client = OpenAI(base_url="http://127.0.0.1:8787/v1", api_key="sk-dummy")

Docs

→ Full documentation — setup, the coding assistant and its action set, conversations, models, generating images / video / music, credits, configuration, troubleshooting, and tests.

→ Headless deployment — Docker + noVNC, for running it 24/7 on a server.

Notes

This drives your own AiPASS account through a browser you are already signed in to. It does not bypass authentication, scrape, or share anything — it gives a great free service the developer interface it was missing. Be reasonable with it, and keep your bridge on localhost.

Built on Node with no runtime dependencies, plus an MV3 Chrome extension. npm run dev:next still starts the Next.js app that this repo was scaffolded from.

Security

The bridge has no authentication of its own — keep it on 127.0.0.1. Anything that can reach the port can spend the account's credits.

If you cloned or forked before 2 Sep 2026, update. Copies taken before 8cad676 have a bridge that any website you visited could drive. See SECURITY.md.

Contributing

See CONTRIBUTING.md. The short version: check git config user.email before you commit, run npm test, and list every file you touched — including the incidental ones.

Credits

License

MIT. Contributions are welcome and are taken under the same terms.

aipass-bridge (niawjunior/aipass-bridge)

Searching Database…

151 ·GitHub
Aipass-bridge
Что это?AiPASS даёт каждому гражданину Таиланда бесплатный доступ к 30+ профессиональным ИИ-моделям, но только через веб-чат. Этот мост переносит доступ в ваш терминал, редактор или любой OpenAI-совместимый инструмент и позволяет ему читать и записывать ваши локальные файлы.
Это CLI-инструмент или скорее приложение?Это локальный мост-сервер на Node.js в паре с расширением для Chrome (MV3). Расширение управляет вашей уже авторизованной вкладкой AiPASS в браузере, а сервер выставляет её как OpenAI-совместимый API, к которому вы обращаетесь из терминала, редактора или любого SDK.
Как его запустить?Загрузите распакованное расширение в Chrome (chrome://extensions, режим разработчика, Load unpacked, выбрав aipass-bridge/extension), откройте вкладку de.aipass.net/chat и дождитесь, пока во всплывающем окне не появится надпись Connected, затем выполняйте команды вроде npm run chat либо направьте любой OpenAI-совместимый клиент на мост.
Нужен ли аккаунт AiPASS, прежде чем этим пользоваться?Да — нужен уже существующий, авторизованный аккаунт AiPASS, открытый в Chrome: мост управляет живой браузерной сессией, а не хранит собственные учётные данные. Отдельный API-ключ помимо логина AiPASS не требуется.
Безопасно ли открывать мост за пределы моей машины?Нет — он поставляется без собственной аутентификации, поэтому всё, что дотягивается до порта, может тратить кредиты вашего аккаунта; держите его привязанным к 127.0.0.1 и немедленно обновитесь, если ваш клон старше коммита 8cad676: старые копии мог контролировать любой посещённый вами сайт.
Куда попадают мои учётные данные AiPASS?Никуда возле моста — реальный запрос выполняется как обычный JavaScript страницы внутри вашей авторизованной вкладки Chrome, поэтому сессионную cookie прикрепляет сам Chrome, а мост никогда не видит учётных данных и ничего не пишет на диск.
Какие модели и типы медиа он умеет генерировать?Он открывает все модели, доступные вашему аккаунту AiPASS, — всего 33, сгруппированные так же, как в веб-интерфейсе, включая генераторы изображений, видео (Seedance, Veo) и музыки (Lyria).
Можно запустить его без присмотра на сервере?Да, есть настройка headless-развёртывания на Docker с noVNC, чтобы браузерная сессия оставалась живой круглосуточно и не требовался включённый ноутбук.
Он подключается напрямую к OpenAI SDK?Да, он даёт готовый OpenAI-совместимый эндпоинт, так что openai SDK или любой инструмент с настраиваемым base URL можно направить прямо на него.
Он может править код в моём проекте, а не только болтать?Да, есть агентный режим, который читает, ищет и правит указанный каталог проекта, а после каждого запуска отчитывается о стоимости в кредитах.
What are similar projects?gpt4free, repomix, mcp-chrome, XActions, Endoplexity, wechat-chatgpt, shuohao-skills, mixdog
Which topics is it in?music-generation, openai-api, chrome-extension, browser-extension, document-processing, browser-automation, video-generation, image-generation, chatbot, agent, security, automation
Creator
niawjunior
Size
4.4 MB
Stars
151
Updated
CommitSep 05Releasev0.2.0Sep 03
Age
1mo
Commits · 90 Days