MCPcopy Index your code
hub / github.com/aurora-develop/aurora

github.com/aurora-develop/aurora @v2.3.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.3.4 ↗ · + Follow
708 symbols 1,901 edges 51 files 160 documented · 23% 1 cross-repo links updated 2d agov2.3.4 · 2026-06-24★ 2,3702 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

AURORA

Aurora converts the ChatGPT Web backend into an OpenAI-style API, supporting chat, Responses, file-based Q&A, image generation, image variations, speech-to-text, text-to-speech, model listings, and obtaining a valid ChatGPT access_token via refresh_token / session_token.

API Documentation

For full endpoints, authentication, token exchange, and curl examples, see: API.md

Features

  • OpenAI-style /v1/chat/completions with streaming and non-streaming support, including parameters such as temperature/top_p/max_tokens/stop/reasoning_effort/response_format/stream_options.include_usage.
  • OpenAI-style /v1/responses with string input, message arrays, instructions, streaming events, and parameters such as reasoning.effort/text.query.format/temperature.
  • /v1/files for file uploads; after uploading, you can include file_id in chat or Responses requests for file-based Q&A.
  • /v1/images/generations for image generation; the model list includes gpt-image-2, supports SSE streaming, and can return either URLs or b64_json.
  • /v1/images/edits for image editing and /v1/images/variations for image-to-image generation (variations).
  • /v1/audio/speech for text-to-speech (TTS), compatible with common OpenAI voices and output formats.
  • /v1/audio/transcriptions for speech-to-text, supporting mp3/wav/m4a/ogg/flac/webm formats.
  • /v1/audio/translations for audio translation into English.
  • /v1/models for model listing.
  • /auth/refresh: pass an OpenAI refresh_token to obtain an access_token.
  • /auth/session: pass a ChatGPT session_token to obtain a new session_token and access_token.
  • /backend-api/conversation for direct proxying of raw ChatGPT conversation requests.
  • Support for access_tokens.txt account pool, free_tokens.txt free UUID pool, automatic free account generation, proxy pool, and TLS.

Deployment

Build from source

git clone https://github.com/aurora-develop/aurora
cd aurora
go build -o aurora
chmod +x ./aurora
./aurora

Docker

docker run -d \
  --name aurora \
  -p 8080:8080 \
  ghcr.io/aurora-develop/aurora:latest

Docker Compose

mkdir aurora
cd aurora
# Place the docker-compose.yml from the repository into the current directory, then run:
docker-compose up -d

Configuration

No additional configuration is required by default. You can configure via .env, system environment variables, or environment variables with the same name on your deployment platform:

SERVER_HOST=0.0.0.0
SERVER_PORT=8080
FREE_ACCOUNTS=true
FREE_ACCOUNTS_NUM=1024
Authorization=your_authorization
TLS_CERT=path_to_your_tls_cert
TLS_KEY=path_to_your_tls_key
PROXY_URL=your_proxy_url

Details:

  • SERVER_HOST / SERVER_PORT: Service listening address and port.
  • Authorization: Service access key. When configured, requests must include Authorization: Bearer your_authorization in the header.
  • FREE_ACCOUNTS: Whether to automatically generate free UUID accounts; disabled by default.
  • FREE_ACCOUNTS_NUM: Number of automatically generated free UUID accounts; default is 1024.
  • TLS_CERT / TLS_KEY: When both are configured, HTTPS is enabled.
  • PROXY_URL: Proxy pool address.

Local account files:

  • access_tokens.txt: One ChatGPT access_token per line, used for features that require a logged-in account.
  • free_tokens.txt: One UUID device ID per line, serving as a free account pool.

Notes

  • Image, TTS, and file features depend on a logged-in access token and are unavailable with free UUID accounts.
  • STREAM_MODE=false forcibly disables streaming for Chat Completions.
  • This project is a ChatGPT Web capability conversion service. The endpoint shapes are designed to be compatible with the OpenAI API as much as possible, but it is not an official OpenAI service.

Acknowledgments

Thanks to all the contributors for their PR support.

Reference Projects

License

MIT License

Friendly Links

Extension points exported contracts — how you extend this code

AuroraHttpClient (Interface)
(no doc) [3 implementers]
httpclient/Iaurorahttpclient.go

Core symbols most depended-on inside this repo

Set
called by 167
httpclient/Iaurorahttpclient.go
setReg
called by 72
internal/turnstile/turnstile.go
setReg
called by 69
internal/so/so.go
withOrderedKeys
called by 54
internal/turnstile/turnstile.go
getReg
called by 44
internal/so/so.go
getReg
called by 43
internal/turnstile/turnstile.go
String
called by 33
typings/official/response.go
Request
called by 31
httpclient/Iaurorahttpclient.go

Shape

Function 438
Struct 134
Method 128
TypeAlias 5
FuncType 2
Interface 1

Languages

Go100%

Modules by API surface

internal/chatgpt/request.go138 symbols
initialize/handlers.go56 symbols
typings/official/request.go51 symbols
internal/turnstile/turnstile.go44 symbols
typings/official/response.go43 symbols
internal/chatgpt/request_test.go41 symbols
internal/chatgpt/artifacts.go40 symbols
internal/so/so.go36 symbols
internal/toolcall/parser_test.go30 symbols
internal/prooftoken/prooftoken.go21 symbols
internal/toolcall/parser.go17 symbols
typings/chatgpt/request.go13 symbols

Used by 1 indexed graphs manifest dependencies, hub-wide

Dependencies from manifests, versioned

github.com/andybalholm/brotliv1.2.1 · 1×
github.com/andybalholm/cascadiav1.3.4 · 1×
github.com/bdandy/go-errorsv1.2.2 · 1×
github.com/bdandy/go-socks4v1.2.3 · 1×
github.com/bogdanfinn/fhttpv0.6.8 · 1×
github.com/bogdanfinn/quic-go-utlsv1.0.9-utls · 1×
github.com/bogdanfinn/utlsv1.7.7-barnius · 1×
github.com/bogdanfinn/websocketv1.5.5-barnius · 1×
github.com/bytedance/gopkgv0.1.4 · 1×

For agents

$ claude mcp add aurora \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact