whatisgithub

What is kiro-stack?

linuxgarry/kiro-stack — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A self-hosted proxy manager that routes each AI service account through its own separate proxy, with DNS tamper detection and automatic failover.

Mindmap

mindmap
  root((kiro-stack))
    What it does
      Per-account proxy routing
      Detects DNS tampering
      Auto fallback on failure
    Tech stack
      Python
      Docker
      Clash
    Use cases
      Isolate account traffic
      Rotate proxy sessions
      Compatible API endpoint
    Audience
      Developers
      Self-hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Route each of several AI service accounts through a distinct proxy or Clash node.

USE CASE 2

Detect and work around DNS resolution that has been tampered with or blocked.

USE CASE 3

Automatically rotate tunnel proxy sessions after repeated connection failures.

USE CASE 4

Expose a local Claude and OpenAI compatible API endpoint backed by proxied accounts.

What is it built with?

PythonDockerClash

How does it compare?

linuxgarry/kiro-stack0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity4/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker and, for per-account tunnel proxies, credentials from a commercial proxy provider.

No license information is provided in the README.

So what is it?

Kiro-stack, this fork, is a self-hosted proxy manager designed for people who run multiple AI service accounts and need each one to connect through its own separate proxy. It sits between your API clients and an AI service, routing each account's traffic through its own designated network exit point so the accounts appear to originate from different locations. The system is built around Clash subscription support, Clash being a network routing tool that loads a list of proxy nodes from a subscription URL. Each account in the admin panel can be bound to a specific node from a loaded subscription, to a per-account HTTP or SOCKS5 proxy from commercial services such as Bright Data, Rola, or Oxylabs, or to a global tunnel proxy. If the primary route fails with a connection error, the system automatically falls back through a configured fallback chain rather than going direct. Several reliability features are included. A component called DNSGuard checks whether DNS resolution results look tampered with, treating results that resolve to loopback or private addresses as a sign of pollution, and retries through alternative DNS-over-HTTPS providers. Tunnel proxies that include a session placeholder in their URL automatically rotate to a fresh session after repeated failures. A circuit breaker panel lets you configure failure thresholds per account to stop a broken proxy from continuing to send requests, with manual controls to open or close the breaker for a single account. The admin panel also exposes an API compatible with Claude and OpenAI client libraries, so existing tools can point at the local server without code changes. Everything runs as a single Docker container by default in the current version, with an older two-container layout still available for standalone debugging. The project is written in Python and is a fork of an existing kiro-stack project, with a changelog tracking each version's additions. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me deploy kiro-stack as a single Docker container with per-account proxy bindings.
Prompt 2
Explain how DNSGuard in kiro-stack detects and works around DNS pollution.
Prompt 3
Walk me through configuring a Bright Data or Oxylabs proxy for one account in the admin panel.
Prompt 4
Show me how the circuit breaker settings prevent a broken proxy from being reused.

Frequently asked questions

What is kiro-stack?

A self-hosted proxy manager that routes each AI service account through its own separate proxy, with DNS tamper detection and automatic failover.

What language is kiro-stack written in?

Mainly Python. The stack also includes Python, Docker, Clash.

What license does kiro-stack use?

No license information is provided in the README.

How hard is kiro-stack to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is kiro-stack for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.