Kiro-Go

Convert Kiro accounts to OpenAI / Anthropic compatible API service.

English | 中文

Features

• 🔄 Anthropic Claude API - Full support for /v1/messages endpoint
• 🤖 OpenAI Chat API - Compatible with /v1/chat/completions
• ⚖️ Multi-Account Pool - Round-robin load balancing
• 🔐 Auto Token Refresh - Seamless token management
• 📡 Streaming - Real-time SSE responses
• 🎛️ Web Admin Panel - Easy account management
• 🔑 Multiple Auth Methods - AWS Builder ID, IAM Identity Center (Enterprise SSO), SSO Token, Local Cache, Credentials
• 📊 Usage Tracking - Monitor requests, tokens, and credits
• 📦 Account Export/Import - Compatible with Kiro Account Manager format
• 🔄 Dynamic Model List - Auto-synced from Kiro API with caching
• 🔔 Version Update Check - Automatic new version notification
• 🌐 i18n - Chinese / English admin panel

Quick Start

Docker Compose (Recommended)

git clone https://github.com/Quorinex/Kiro-Go.git
cd Kiro-Go

# Create data directory for persistence
mkdir -p data

docker-compose up -d

Docker Run

# Create data directory
mkdir -p /path/to/data

docker run -d \
  --name kiro-go \
  -p 8080:8080 \
  -e ADMIN_PASSWORD=your_secure_password \
  -v /path/to/data:/app/data \
  --restart unless-stopped \
  ghcr.io/quorinex/kiro-go:latest

📁 The /app/data volume stores config.json with accounts and settings. Mount it for data persistence.

Build from Source

git clone https://github.com/Quorinex/Kiro-Go.git
cd Kiro-Go
go build -o kiro-go .
./kiro-go

Configuration

Config file is auto-created at data/config.json on first run:

{
  "password": "changeme",
  "port": 8080,
  "host": "127.0.0.1",
  "requireApiKey": false,
  "apiKey": "",
  "accounts": []
}

⚠️ Change the default password before production use!

Environment Variables

Variable	Description	Default
CONFIG_PATH	Config file path	data/config.json
ADMIN_PASSWORD	Admin panel password (overrides config)	-

Usage

1. Access Admin Panel

Open http://localhost:8080/admin and login with your password.

2. Add Accounts

Multiple methods available:

Method	Description
AWS Builder ID	Login with AWS Builder ID (personal accounts)
IAM Identity Center (Enterprise SSO)	Login with IAM Identity Center (enterprise accounts)
SSO Token	Import x-amz-sso_authn token from browser
Kiro Local Cache	Import from local Kiro IDE cache files
Credentials JSON	Import JSON from Kiro Account Manager

Credentials Format

{
  "refreshToken": "eyJ...",
  "accessToken": "eyJ...",
  "clientId": "xxx",
  "clientSecret": "xxx"
}

3. Call API

Claude API

curl http://localhost:8080/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

OpenAI API

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer any" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Model Mapping

Request Model	Actual Model
claude-sonnet-4-20250514	claude-sonnet-4-20250514
claude-sonnet-4.5	claude-sonnet-4.5
claude-haiku-4.5	claude-haiku-4.5
claude-opus-4.5	claude-opus-4.5
claude-opus-4.6	claude-opus-4.6
gpt-4o, gpt-4	claude-sonnet-4-20250514
gpt-3.5-turbo	claude-sonnet-4-20250514

Thinking Mode

Enable extended thinking by adding a suffix to the model name (default: -thinking).

Usage

# OpenAI API with thinking
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.5-thinking",
    "messages": [{"role": "user", "content": "Solve this step by step: 15 * 23"}],
    "stream": true
  }'

# Claude API with thinking
curl http://localhost:8080/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4.5-thinking",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Analyze this problem"}]
  }'

Configuration

Configure thinking mode in the Admin Panel under Settings > Thinking Mode Settings:

Setting	Description	Options
Trigger Suffix	Model name suffix to enable thinking	Default: -thinking (customizable, e.g., -think, -reason)
OpenAI Output Format	How thinking content is returned in OpenAI API	reasoning_content (DeepSeek compatible), <thinking> tag, <think> tag
Claude Output Format	How thinking content is returned in Claude API	<thinking> tag (default), <think> tag, plain text

Output Formats

OpenAI API (/v1/chat/completions):

• reasoning_content - Thinking in separate reasoning_content field (DeepSeek compatible)
• thinking - Thinking wrapped in <thinking>...</thinking> tags in content
• think - Thinking wrapped in <think>...</think> tags in content

Claude API (/v1/messages):

• thinking - Thinking wrapped in <thinking>...</thinking> tags (default)
• think - Thinking wrapped in <think>...</think> tags
• reasoning_content - Plain text output

API Endpoints

Endpoint	Description
GET /health	Health check
GET /v1/models	List models
GET /v1/stats	Statistics
POST /v1/messages	Claude Messages API
POST /v1/messages/count_tokens	Token counting
POST /v1/chat/completions	OpenAI Chat API
GET /admin	Admin panel

Project Structure

Kiro-Go/
├── main.go              # Entry point
├── version.json         # Version info for update check
├── config/              # Configuration management
├── pool/                # Account pool & load balancing
├── proxy/               # API handlers & Kiro client
│   ├── handler.go       # HTTP routing & admin API
│   ├── kiro.go          # Kiro API client
│   ├── kiro_api.go      # Kiro REST API (usage, models)
│   └── translator.go    # Request/response conversion
├── auth/                # Authentication
│   ├── builderid.go     # AWS Builder ID login
│   ├── iam_sso.go       # IAM SSO login
│   ├── oidc.go          # OIDC token refresh
│   └── sso_token.go     # SSO token import
├── web/                 # Admin panel frontend
├── Dockerfile
└── docker-compose.yml

Disclaimer

This project is provided for educational and research purposes only.

• This software is not affiliated with, endorsed by, or associated with Amazon, AWS, or Kiro in any way
• Users are solely responsible for ensuring their use complies with all applicable terms of service and laws
• The authors assume no liability for any misuse or violations arising from the use of this software
• Use at your own risk

By using this software, you acknowledge that you have read and understood this disclaimer.

License

MIT