CodeBuddy2API + Kiro Gateway

OpenAI-compatible proxy for CodeBuddy and Kiro (Amazon Q Developer) — access Claude Opus 4.7, Sonnet 4.5, GLM-5, Qwen3, and more via a single local API.

---

✨ Features

• 🔑 Kiro Gateway — Use ksk_ API keys from Kiro IDE to access Claude models via AWS
• 🤖 10+ AI Models — Claude Opus 4.7, Opus 4.5, Sonnet 4.5, Haiku 4.5, GLM-5, Qwen3, Minimax, and more
• 🔄 Key Rotation — Automatic round-robin across multiple API keys
• 📡 OpenAI-Compatible — Works with OpenCode, Cursor, Continue, and any OpenAI-compatible client
• 🌊 Streaming Support — Real-time SSE streaming responses
• 🛡️ Error Recovery — Auto-retry with key rotation on 403/429 errors

---

📋 Prerequisites

• Python 3.10+
• Kiro IDE account (free) — to get your ksk_ API key
• Git

---

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/nopperabbo/codebuddy2api.git
cd codebuddy2api

2. Set Up Virtual Environment

python3 -m venv venv
source venv/bin/activate  # macOS/Linux
# or: venv\Scripts\activate  # Windows

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment

cp .env.example .env

Edit .env and set your password:

CODEBUDDY_PASSWORD=your_secret_password_here

5. Add Your Kiro API Key(s)

Create kiro_keys.json in the project root:

[
  {"api_key": "ksk_YOUR_FIRST_KEY_HERE"},
  {"api_key": "ksk_YOUR_SECOND_KEY_HERE"}
]

💡 How to get your ksk_ key: Open Kiro IDE, sign in, then find your API key in Settings → API Keys. It starts with ksk_.

6. Start the Server

bash start.sh

The server will start on http://localhost:8003.

---

🎯 Available Models (Kiro Gateway)

Model ID	Description	Status
claude-opus-4.7	Claude Opus 4.7 — Latest & most capable	✅
claude-opus-4.5	Claude Opus 4.5	✅
claude-sonnet-4.5	Claude Sonnet 4.5	✅
claude-haiku-4.5	Claude Haiku 4.5 — Fast & light	✅
claude-sonnet-4	Claude Sonnet 4	✅
glm-5	GLM-5 (via Kiro)	✅
qwen3-coder-next	Qwen3 Coder Next (via Kiro)	✅
minimax-m2.5	Minimax M2.5 (via Kiro)	✅
minimax-m2.1	Minimax M2.1 (via Kiro)	✅
auto	Let Kiro pick the best model	✅

---

🔗 API Endpoints

Kiro Gateway

Method	Endpoint	Description
GET	/kiro/v1/models	List available Kiro models
POST	/kiro/v1/chat/completions	Chat completions (OpenAI-compatible)
GET	/kiro/v1/keys	List configured API keys (masked)
POST	/kiro/v1/keys	Add a new API key

CodeBuddy (Original)

Method	Endpoint	Description
GET	/codebuddy/v1/models	List CodeBuddy models
POST	/codebuddy/v1/chat/completions	Chat completions
GET	/codebuddy/v1/credentials	List credentials

---

🧪 Quick Test

Test with curl

# List models
curl -s -H "Authorization: Bearer YOUR_PASSWORD" \
  http://localhost:8003/kiro/v1/models | python3 -m json.tool

# Chat with Opus 4.7
curl -s -X POST http://localhost:8003/kiro/v1/chat/completions \
  -H "Authorization: Bearer YOUR_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.7",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

# Streaming
curl -N -X POST http://localhost:8003/kiro/v1/chat/completions \
  -H "Authorization: Bearer YOUR_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.7",
    "messages": [{"role": "user", "content": "Write a haiku about coding"}],
    "stream": true
  }'

---

🛠️ Integration with OpenCode

Add this to your ~/.config/opencode/opencode.json under the "provider" section:

"kiro": {
  "models": {
    "claude-opus-4.7": {
      "limit": { "context": 200000, "output": 64000 },
      "name": "Claude Opus 4.7 (Kiro/AWS)",
      "modalities": {
        "input": ["text", "image", "pdf"],
        "output": ["text"]
      },
      "variants": {
        "low": { "thinkingConfig": { "thinkingBudget": 16384 } },
        "medium": { "thinkingConfig": { "thinkingBudget": 32768 } },
        "high": { "thinkingConfig": { "thinkingBudget": 65536 } },
        "max": { "thinkingConfig": { "thinkingBudget": 128000 } }
      }
    },
    "claude-opus-4.5": {
      "limit": { "context": 200000, "output": 64000 },
      "name": "Claude Opus 4.5 (Kiro/AWS)",
      "modalities": {
        "input": ["text", "image", "pdf"],
        "output": ["text"]
      },
      "variants": {
        "low": { "thinkingConfig": { "thinkingBudget": 16384 } },
        "medium": { "thinkingConfig": { "thinkingBudget": 32768 } },
        "high": { "thinkingConfig": { "thinkingBudget": 65536 } },
        "max": { "thinkingConfig": { "thinkingBudget": 128000 } }
      }
    },
    "claude-sonnet-4": {
      "limit": { "context": 200000, "output": 64000 },
      "name": "Claude Sonnet 4 (Kiro/AWS)",
      "modalities": {
        "input": ["text", "image", "pdf"],
        "output": ["text"]
      },
      "variants": {
        "low": { "thinkingConfig": { "thinkingBudget": 8192 } },
        "medium": { "thinkingConfig": { "thinkingBudget": 16384 } },
        "high": { "thinkingConfig": { "thinkingBudget": 24576 } },
        "max": { "thinkingConfig": { "thinkingBudget": 32768 } }
      }
    },
    "auto": {
      "limit": { "context": 200000, "output": 64000 },
      "name": "Auto (Kiro/AWS Best Pick)",
      "modalities": {
        "input": ["text", "image", "pdf"],
        "output": ["text"]
      },
      "variants": {
        "low": { "thinkingConfig": { "thinkingBudget": 8192 } },
        "medium": { "thinkingConfig": { "thinkingBudget": 16384 } },
        "high": { "thinkingConfig": { "thinkingBudget": 24576 } },
        "max": { "thinkingConfig": { "thinkingBudget": 32768 } }
      }
    }
  },
  "name": "Kiro (Amazon Q)",
  "npm": "@ai-sdk/openai-compatible",
  "options": {
    "apiKey": "YOUR_PASSWORD",
    "baseURL": "http://127.0.0.1:8003/kiro/v1"
  }
}

Then select kiro/claude-opus-4.7 as your model in OpenCode.

---

🔧 Integration with Cursor / Continue / Other Tools

Use these settings in any OpenAI-compatible client:

Setting	Value
Base URL	http://localhost:8003/kiro/v1
API Key	Your CODEBUDDY_PASSWORD from .env
Model	claude-opus-4.7 (or any from the list above)

---

📁 Project Structure

codebuddy2api/
├── src/
│   ├── __init__.py
│   ├── auth.py              # Authentication middleware
│   ├── codebuddy_router.py  # CodeBuddy proxy router
│   ├── kiro_api_client.py   # Kiro API client & model mapping
│   ├── kiro_router.py       # Kiro gateway router
│   └── ...
├── kiro_keys.json           # Your ksk_ API keys (gitignored)
├── .env                     # Environment config (gitignored)
├── .env.example             # Example environment file
├── requirements.txt         # Python dependencies
├── start.sh                 # Startup script
└── web.py                   # Main application entry point

---

⚠️ Important Notes

• Keep your ksk_ keys safe — they provide direct access to the Kiro API
• kiro_keys.json is gitignored — your keys will never be accidentally committed
• The server runs on port 8003 by default
• All requests require the Authorization: Bearer YOUR_PASSWORD header
• Multiple ksk_ keys are supported — the server rotates through them automatically

---

🤝 Credits

• kiro-gateway — Reference implementation for Kiro API integration
• Amazon Q Developer — The underlying AI service

---

📄 License

MIT