annodex

Codex in Your Browser — No VPN, No ChatGPT Account

A browser workspace for Codex that works with any LLM provider. Fully compatible with Codex CLI config and history. Built for bioinformatics, data science, and anyone who wants AI-assisted coding without the setup burden.

Why Annodex Exists

Codex is powerful, but accessing it shouldn't require a VPN, a ChatGPT subscription, or terminal expertise.

The Problems

🔐

Codex Desktop Needs VPN + ChatGPT

The official Codex desktop app requires a ChatGPT Plus/Pro subscription and network access that many users in China and other regions cannot easily obtain.

🖥️

Codex CLI Is Not for Everyone

The CLI version is powerful but demands terminal comfort. No image viewing, no file preview, no visual feedback — a high barrier for scientists and non-developers.

🔌

DeepSeek & Codex Don't Mix

DeepSeek is affordable and capable, but its API uses the chat/completions format while Codex requires the responses format. Using them together is painful without a bridge.

How Annodex Solves Them

🌐

Browser-Based. Zero Friction.

Annodex wraps Codex in a browser workspace. No VPN. No ChatGPT account. Just open your browser and start working with your local files.

🔄

Full CLI Compatibility

Annodex reads the same config, providers, and chat history as Codex CLI. Switch between them freely — your work is always in sync.

🧠

Any Model, One Interface

DeepSeek, OpenAI, Anthropic — configure providers from the Settings → Models screen or providers.json. Annodex normalizes the API differences so every model just works.

Features

📁

Auto Project Archiving

Chats are automatically organized by project directory. Bioinformatics pipelines, analysis notebooks, code reviews — each project keeps its own threaded history.

🎨

Generative UI

Annnodex renders rich outputs inline: flowcharts, Mermaid diagrams, data tables, and rendered Markdown. Perfect for visualizing bioinformatics workflows.

🧬

Bioinformatics-Aware

Understands bioinformatics software execution logic. Parse pipeline logs, generate workflow diagrams, and track analysis provenance — all in your browser.

🛠️

Skills & Tools

Configure tool presets and skill sets per session. From single-cell analysis to variant calling — give the agent the right tools for your domain.

Live Runtime & SSE

See the agent thinking, running tools, and streaming results in real time. No more guessing whether the CLI is still working.

🖼️

File & Image Viewer

Browse project files, preview images, inspect generated reports — all alongside the conversation. The CLI can't do this.

See It in Action

Chat with Project Context
Projects
rna-seq-atlas
single-cell-qc
variant-review
deepseek-chatthinking: mediumtools: full
I'll analyze the RNA-seq pipeline. Let me check the project files first...
Generate a workflow diagram and summarize the QC results.
Model Configuration
{
"providers": {
"deepseek": {
"apiKey": "sk-••••••••",
"baseURL": "https://api.deepseek.com"
},
"openai": {
"apiKey": "sk-••••••••"
}
}
"models": [
{ "id": "deepseek-chat", "provider": "deepseek" },
{ "id": "gpt-4o", "provider": "openai" }
]
}
Generative UI — Workflow Diagrams
Raw Data
FastQC
Trimming
Alignment
Quantification
DEG Analysis
Report

Use It from Desktop or Mobile

Configure models, preview files, monitor running chats, and continue work from a phone browser when Annodex is running on a server.

Annodex desktop chat workspace
Desktop chat with generated visual output and runtime tools.
Annodex mobile chat
Mobile chat with model controls and compact input.
Annodex model setup
Model setup from Settings → Models.
Annodex file preview
Markdown and report preview in Files.
Annodex runtime tools
Running chats and Abort controls in Tools.

Installation

01

Windows: Install Miniforge

Download from Miniforge3-Windows-x86_64.exe

After installation, search Miniforge, then run Miniforge Prompt as administrator.

02

Install Node.js

conda update -n base -c conda-forge conda
conda install -c conda-forge nodejs

Run these commands in Miniforge Prompt.

03

Install Codex & Annodex

npm install -g @openai/codex
npm install -g @seqyuan/annodex
codex

If Codex asks you to log in, press Ctrl+C to exit.

04

Start and set model

annodex

Press Enter through prompts. Then open Settings → Models, paste your DeepSeek API key, and save.

关注公众号获取更新

微信公众号搜索 seqyuan,查看 annodex 使用教程、Windows 安装说明和生信 AI 工作流案例。

微信搜一搜 seqyuan
Quick Start Commands
# Windows: run in Miniforge Prompt as administrator
conda update -n base -c conda-forge conda
conda install -c conda-forge nodejs
npm install -g @openai/codex
npm install -g @seqyuan/annodex
codex   # press Ctrl+C if login appears
annodex # press Enter through prompts

# Linux server
annodex --hostname 0.0.0.0
# Open http://<server-ip>:30121 from another device