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 多个专业 AI 模型,但只能通过网页聊天框。这个桥接器把这种能力带进你的终端、编辑器或任何 OpenAI 兼容工具,并让它能读写你的本地文件。
这是命令行工具,还是更像一个应用？它是一个本地 Node.js 桥接服务器,搭配一个 Chrome 扩展(MV3)。扩展驱动你已登录的 AiPASS 浏览器标签页,服务器则把它暴露为 OpenAI 兼容 API,供你从终端、编辑器或任何 SDK 调用。
怎么让它跑起来？在 Chrome 里加载已解压的扩展(chrome://extensions → 开发者模式 → 加载已解压的扩展程序,选择 aipass-bridge/extension),打开一个 de.aipass.net/chat 标签页,直到弹窗显示 “Connected”,然后运行 npm run chat 之类的命令,或把任何 OpenAI 兼容客户端指向这个桥接器。
用之前需要 AiPASS 账号吗？需要——你需要一个已登录的 AiPASS 账号在 Chrome 中保持打开,因为桥接器驱动的是那个实时浏览器会话,而不是自己保存凭据。除了 AiPASS 登录,不需要单独的 API 密钥。
把桥接器暴露到自己电脑之外安全吗？不安全——它本身不带任何身份验证,任何能访问该端口的东西都能消耗你账户的额度;请保持它只绑定 127.0.0.1,如果你的克隆早于 commit 8cad676,请立即更新,因为旧版本可能被你访问过的任何网站驱动。
我的 AiPASS 登录凭据会去向哪里？完全不经过桥接器——实际请求是以普通页面 JavaScript 的形式,在你自己已登录的 Chrome 标签页里运行的,所以 Chrome 会自动附上会话 cookie,桥接器既看不到凭据,也不向磁盘写任何东西。
它能调用哪些模型、生成哪些媒体？它暴露你的 AiPASS 账号可选的全部模型,共 33 个,分组方式与网页界面一致,包括图像、视频(Seedance、Veo)和音乐(Lyria)生成器。
能在服务器上无人值守地运行吗？可以。它提供使用 Docker 加 noVNC 的无头部署方案,让浏览器会话 7×24 小时保持存活,不用一直开着你的笔记本。
它能直接接入 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