TetherIQ ⚡

자율 AI 코딩 에이전트를 위한 제로 구성 로컬 데스크톱 컨트롤 플레인 및 프록시 게이트웨이(127.0.0.1:4000).
자동 모델 장애 조치, 하드 런어웨이 지출 상한, 6개 이상의 클라이언트 환경에서의 1클릭 동적 MCP 도구 동기화, 실시간 토큰 텔레메트리 HUD, 전체 스펙트럼 활동 추적을 제공합니다.

⚡ 60초 빠른 시작 가이드

TetherIQ를 3가지 간단한 단계로 시작하세요:

1. TetherIQ 다운로드 및 실행

• TetherIQ 데스크톱 애플리케이션(.exe, .dmg, .deb)을 실행합니다.

• TetherIQ가 http://127.0.0.1:4000에서 로컬 프록시 게이트웨이를 자동으로 실행합니다.

2. 공급자 API 키 입력

• 상단 바에서 **"키"**를 클릭하거나 60초 빠른 시작 마법사를 엽니다.

• Anthropic, OpenAI, AWS Bedrock, Google Vertex, Groq 또는 로컬 Ollama 자격 증명을 추가합니다.
  (키는 데스크톱 볼트에 엄격히 로컬로 보관되며 제3자 클라우드 서버로 전송되지 않습니다).

3. 코딩 에이전트/도구 연결

아래에서 에이전트를 선택하고 한 단계로 연결하세요:

🟢 Claude Code CLI

export ANTHROPIC_BASE_URL=http://127.0.0.1:4000
claude

또는 TetherIQ에서 "Claude Code 자동 구성"을 클릭하여 ~/.claude.json에 주입합니다.

🟣 AI IDE (Cursor, Windsurf, Devin, Antigravity)

• 기본 URL: http://127.0.0.1:4000/v1

• 모델: fast-code(저지연) 또는 heavy-reasoning(심층 추론)

• MCP 자동 동기화: TetherIQ의 도구 허브에서 **"연결 및 모든 파일 자동 구성"**을 클릭하여 50개 이상의 MCP 서버를 ~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, devin.json 또는 .mcp.json에 주입합니다.

🔵 Python 및 TypeScript SDK

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:4000/v1",
    api_key="tetheriq-local"
)

response = client.chat.completions.create(
    model="heavy-reasoning",
    messages=[{"role": "user", "content": "Refactor this architecture"}]
)
print(response.choices[0].message.content)

Related MCP server: Proxima

🛡️ 핵심 기능

1. 이중 게이트웨이 엔진(127.0.0.1:4000):

   • OpenAI(/v1/chat/completions, /v1/models) 및 Anthropic(/v1/messages) 프로토콜 완전 호환.

   • 낮은 루프백 지연 시간($< 5\text{ ms}$).

2. 탄력적 모델 장애 조치 매트릭스:

   • 선형 및 계층적 우선순위 체인(예: Anthropic $\rightarrow$ AWS Bedrock $\rightarrow$ Groq $\rightarrow$ Ollama).

   • 활성 에이전트 CLI 세션을 중단하지 않고 429 Too Many Requests 및 503 Service Unavailable 오류를 자동으로 복구합니다.

   • 가상 모델 별칭: fast-code 및 heavy-reasoning.

3. 하드 런어웨이 지출 회로 차단기:

   • 시각적인 일일/월별 지출 한도 다이얼(예: $10.00/일).

   • 런어웨이 재귀 에이전트 루프를 HTTP 402 Budget Exceeded: TetherIQ spend limit reached 오류로 자동 차단합니다.

4. 50개 이상의 공식 및 검증된 MCP 도구 마켓플레이스:

   • Databricks, Snowflake, Supabase, PostgreSQL, Notion, Slack, Jira, GitHub, Docker, Sentry, Brave Search, Pinecone 등 40개 이상의 검증된 스키마.

   • Cursor, Windsurf, Devin, Claude Code CLI, Claude Desktop, Antigravity에 대한 1클릭 동시 비파괴 구성 파일 주입.

5. 심층 관찰 가능성 및 활동 추적:

   • 실시간 스팬 워터폴 시각화 도구.

   • 마이크로초 단위 지연 시간 분석, 프롬프트/페이로드 검사기, OpenTelemetry 호환 트레이스.

6. 내장 실행 터미널:

   • 프록시 게이트웨이 환경 변수가 미리 로드된 네이티브 호스트 셸(powershell.exe, zsh, bash)을 실행하는 통합 드로어.

7. 1클릭 비식별화 디버그 리포터:

   • 모든 API 키와 베어러 토큰이 자동으로 마스킹된(sk-ant-***, ghp_***) 깨끗한 GitHub 이슈 마크다운을 생성합니다.

🛠️ 로컬 개발 및 빌드

# Install dependencies
npm install

# Start Vite React UI
npm run dev

# Start local proxy gateway core
npm run proxy

# Build production bundle
npm run build

Tauri v2, React 19, TypeScript, Tailwind CSS, LiteLLM 게이트웨이 코어로 구축되었습니다.