
Proteção poderosa para agentes de IA - Segurança de código aberto e rastreamento de custos para aplicações de IA
SDK de Segurança e Governança para Agentes de IA
Governança determinística, proteções, rastreamento de custos e gerenciamento de políticas para aplicações LLM. Código aberto. TypeScript + Python. Funciona com qualquer provedor.
Site · Documentação · Exemplos · Discord · Contribuir
Instalação: npm install tealtiger ou pip install tealtiger, depois envolva uma chamada OpenAI existente:```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');
18. [Introdução às Ferramentas de Cibersegurança e Ciberataques](https://www.edx.org/learn/cybersecurity/ibm-introduction-to-cybersecurity-tools-cyber-attacks) - Acelere sua carreira em cibersegurança e prepare-se para atender à demanda por profissionais da área.
19. [Cibersegurança para Pequenas e Médias Empresas: Identificando Ameaças e Prevenindo Ataques](https://www.edx.org/learn/cybersecurity/doane-university-cybersecurity-for-small-and-medium-enterprises-identifying-threats) - Descubra um programa de treinamento especializado projetado para ajudar você a proteger pequenas e médias empresas contra ataques cibernéticos.
20. [Desvendando a Segurança da Informação](https://www.edx.org/learn/computer-science/tel-aviv-university-unlocking-information-security) - Uma visão abrangente da segurança da informação - um curso sério para iniciantes da Universidade de Tel Aviv.```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)
INPUT:```text ALLOW Governance receipt emitted; cost and guardrails tracked.
Próximo: [Início Rápido completo](#-quick-start) e [exemplos](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples).
---
## 🔭 observe() — Instrumentação sem Configuração (v1.4)
Uma linha adiciona rastreamento de custos, registro de auditoria, detecção de PII e linhas de base comportamentais a qualquer cliente LLM. Sem arquivos de configuração, sem definições de políticas.```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, ... }
Argumento pode ser um domínio ou um endereço de email.
target Valid input: domain (example.com) or email ([email protected])
--sources - Use para especificar as fontes a serem utilizadas. Valores separados por vírgula.--show-all - Use para mostrar resultados de todas as fontes na saída--local - Use para desativar solicitações HTTP. Apenas pesquisa local.--timeout - Use para alterar o tempo limite padrão de 5 segundos (valor flutuante em segundos)--registry - Use para alterar a URL do registro de pesquisa de username--no-color - Desativa a saída colorida--browse - Use para abrir resultados no navegador padrão--history - Ocultar histórico de usuários por padrão, usar para exibir histórico--csv - Use para criar um arquivo CSV contendo os resultados--json - Use para criar um arquivo JSON contendo os resultados--xpath - Extrai dados usando expressões XPath para serialização XML HTML ou JSONExemplo de uso com múltiplas fontes:
theHarvester -d example.com -l 200 -b bing,yahoo,dnsdumper
``````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, ...)
O que você obtém automaticamente: rastreamento de custo por requisição em 12 provedores, log de auditoria estruturado com IDs de correlação, linha de base comportamental (P50/P95/P99), detecção de PII no modo REPORT_ONLY e um interruptor de parada instantânea via freeze(). Menos de 5ms de overhead por chamada.
Veja examples/observe-quickstart.ts e examples/observe_quickstart.py.
Visibilidade em tempo real da sua frota de agentes de IA — postura de segurança, governança de custos e alertas comportamentais em uma única visualização.
O que você vê rapidamente:
Cada painel é alimentado de forma independente com isolamento de falhas — a falha de um widget nunca afeta os outros.
Execute localmente: cd dashboard/api && npm run dev depois cd dashboard/web && npm run dev (API na porta :3100, UI na :3000)
TealTiger é um SDK de código aberto que fornece governança determinística para agentes de IA. Ele impõe políticas de segurança, rastreia custos e produz evidências estruturadas — tudo em tempo de execução, sem necessidade de infraestrutura.
Procurando o código-fonte? Este é o repositório central. O código-fonte do SDK está nos repositórios específicos por linguagem:
- SDK TypeScript: tealtiger-typescript-prod
- SDK Python: tealtiger-python-prod
Ou clone este repositório com submódulos:
git clone --recurse-submodules https://github.com/agentguard-ai/tealtiger.git
Ao contrário de filtros de segurança probabilísticos, o TealTiger usa avaliação determinística de políticas: mesma entrada + mesma política = mesma decisão, todas as vezes. Cada veredito de governança é reconstruível, rastreável até o humano que criou a política e exportável como evidência estruturada (SARIF, JUnit XML, JSON).
Princípio-chave: A governança deve ser uma propriedade de engenharia incorporada no runtime — não um documento revisado depois do fato.
npm install tealtiger
.```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.
pip install tealtiger
INPUT:```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.
Princípio de design: Nenhum LLM no caminho de governança. Mesma entrada + mesma política = mesma decisão, todas as vezes.
Use o badge TealTiger para mostrar que um projeto é governado por políticas determinísticas de segurança e custo de agente.
Badge escuro:```md
[](https://github.com/agentguard-ai/tealtiger)
Use examples/python/huggingface_tgi_quickstart.py para experimentar o provedor protegido Hugging Face Text Generation Inference do SDK Python.```bash
export HF_API_TOKEN="your-hugging-face-token"
export HF_TGI_ENDPOINT="https://your-endpoint.endpoints.huggingface.cloud"
export HF_TGI_MODEL="meta-llama/Meta-Llama-3.1-8B-Instruct"
python examples/python/huggingface_tgi_quickstart.py
O exemplo habilita a configuração de guardrails e rastreamento de custos, envia uma solicitação de chat de amostra, então imprime a resposta, uso de tokens, custo estimado, provedor e ID de correlação. Use valores de espaço reservado na documentação e arquivos `.env.example`; nunca faça commit de um `HF_API_TOKEN` real.
### Esquema de Política do TealEngine
Use [`schemas/tealtiger-policy.schema.json`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/schemas/tealtiger-policy.schema.json) para autocompletar e validar no editor ao escrever arquivos de política JSON ou YAML do TealEngine. Arquivos de política JSON podem incluir:```json
{
"$schema": "./schemas/tealtiger-policy.schema.json"
}
Para políticas YAML, configure o mapeamento de esquema YAML do seu editor para apontar arquivos de política como tealtiger-policy.yml em ./schemas/tealtiger-policy.schema.json.
Use o script de validação de políticas para verificar um arquivo JSON de política TealTiger antes de usá-lo em CI/CD ou governança em tempo de execução:```bash npm install npx ts-node scripts/validate-policy.ts ./my-policy.json
Você também pode executar o script npm:```bash
npm run validate:policy -- ./my-policy.json
O validador carrega
schemas/tealtiger-policy.schema.json,
imprime erros de validação do esquema, sai com 0 quando a política é válida e sai
com 1 quando a política é inválida.
TealTiger é open source e estamos à procura de contribuidores iniciais para moldar o futuro da governança de agentes de IA.
git clone https://github.com/agentguard-ai/tealtiger-typescript-prod.git
git clone https://github.com/agentguard-ai/tealtiger-python-prod.git
Veja [CONTRIBUTING.md](https://github.com/agentguard-ai/tealtiger/blob/HEAD/CONTRIBUTING.md) para diretrizes detalhadas.
---
## 🗺️ Roteiro
**Atual:** v1.4.0 — Adoção Zero-Config e Painel de Governança (Lançado em 9 de julho de 2026)
- `observe(client)` — Auto-instrumentação em 1 linha para 12 provedores, zero configuração
- `freeze()` / `unfreeze()` — Interruptor de desligamento instantâneo, nenhuma política necessária
- Linha de base comportamental — Perfil P50/P95/P99 construído a partir das primeiras 100 requisições
- Detecção de PII no modo REPORT_ONLY — Digitalização passiva sem bloqueio
- Painel de Governança — reformulado com tema claro, widgets de segurança, isolamento de erros
- Menos de 5ms de sobrecarga por chamada — em processo, determinístico, capaz de funcionar offline
**Anterior:** v1.3.0 — Governança de Agentes Autônomos (Lançado em 18 de maio de 2026)
**Planejado:** v1.5.0 — Plataforma Enterprise (Q4 2026)
- Multitenência com isolamento completo de dados
- RBAC (Proprietário, Administrador, Autor de Políticas, Visualizador, Auditor)
- SSO via SAML 2.0 / OIDC (Okta, Azure AD, Google)
- Exportação para SIEM (Splunk, Elastic, Sentinel, Datadog)
- Estágio de políticas, modo de simulação (dry-run), implantações canary
- Relatórios de conformidade agendados e painel executivo
**Futuro:** v2.0.0 — Plataforma de Segurança SaaS (Q1 2027)
- Plano de controle SaaS completo (modelo CSPM/CWPP para agentes de IA)
- Console executivo do CISO com pontuação de saúde da governança
- Operador e Agente TealTiger para Kubernetes
- Detecção de IA Sombra (descobrir agentes não governados)
- Interruptor de desligamento remoto a partir do console SaaS
- CloudEvents, OpenTelemetry, plugin Backstage
---
## 🌟 Comunidade
- **Discord**: [Junte-se à Comunidade TealTiger](https://discord.gg/X2ePf8QAj)
- **GitHub Discussions**: [Faça perguntas, compartilhe ideias](https://github.com/agentguard-ai/tealtiger/discussions)
- **LinkedIn**: [TealTiger](https://www.linkedin.com/company/tealtiger)
- **X (Twitter)**: [@TealtigerAI](https://x.com/TealtigerAI)
- **Documentação**: [docs.tealtiger.ai](https://docs.tealtiger.ai)
- **Blog**: [blogs.tealtiger.ai](https://blogs.tealtiger.ai)
- **Playground**: [playground.tealtiger.ai](https://playground.tealtiger.ai)
- **Email**: [email protected]
---
## 🔒 Segurança
A TealTiger está comprometida com práticas responsáveis de segurança em código aberto.
[](https://securityscorecards.dev/viewer/?uri=github.com/agentguard-ai/tealtiger)
[OpenSSF Best Practices](https://www.bestpractices.dev/projects/10824)
[](https://github.com/agentguard-ai/tealtiger/security/dependabot)
[](https://github.com/agentguard-ai/tealtiger/actions/workflows/codeql.yml)
Para relatos de vulnerabilidades, consulte nossa [Política de Segurança](https://github.com/agentguard-ai/tealtiger/blob/HEAD/SECURITY.md).
---
## 📄 Licença
TealTiger é licenciado sob [Apache 2.0](https://github.com/agentguard-ai/tealtiger/blob/HEAD/LICENSE).
---
## 🙏 Agradecimentos
Construído com ❤️ pela equipe TealTiger e [contribuidores](https://github.com/agentguard-ai/tealtiger/blob/HEAD/CONTRIBUTORS.md).
---
## 👥 Contribuidores
[](https://github.com/agentguard-ai/tealtiger/graphs/contributors)
Quer contribuir? Confira nosso guia [CONTRIBUTING.md](https://github.com/agentguard-ai/tealtiger/blob/HEAD/CONTRIBUTING.md)!
---
<div align="center">
**⭐ Dê uma estrela neste repositório se você acredita que agentes de IA precisam de governança, não apenas de barreiras de proteção.**
[Reportar Bug](https://github.com/agentguard-ai/tealtiger/issues/new?template=bug_report.md) · [Solicitar Recurso](https://github.com/agentguard-ai/tealtiger/issues/new?template=feature_request.md) · [Fazer Pergunta](https://github.com/agentguard-ai/tealtiger/issues/new?template=question.md)
</div>
## 🌐 Provedores Suportados
Os dados de preços são de [`docs/cost-comparison.md`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/docs/cost-comparison.md) (última atualização em abril de 2026).
**Cobertura** mostra se a TealTiger verificou o rastreamento de custos por meio da API `observe()` de ponta a ponta.
| Provedor | Modelo Exemplo | Input $/1M | Output $/1M | Cobertura | Exemplo |
| --- | --- | ---: | ---: | :---: | --- |
| **OpenAI** | GPT-5.4 | $2.50 | $15.00 | ✅ | [`examples/observe_quickstart.py`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/observe_quickstart.py) |
| **OpenAI** | GPT-5.4 mini | $0.75 | $4.50 | ✅ | [`examples/observe_quickstart.py`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/observe_quickstart.py) |
| **Anthropic** | Claude Sonnet 4 | $3.00 | $15.00 | ✅ | [`examples/observe_quickstart.py`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/observe_quickstart.py) |
| **Anthropic** | Claude Haiku 3.5 | $0.80 | $4.00 | ✅ | [`examples/observe_quickstart.py`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/observe_quickstart.py) |
| **Anthropic** | Claude Opus 4.1 | $15.00 | $75.00 | 🟡 | — |
| **Gemini** | Gemini 3 Flash Preview | $0.50 | $3.00 | 🛠️ | [`examples/multi-provider-setup.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/multi-provider-setup.ts) |
| **Gemini** | Gemini 3 Pro Preview | $2.00 | $12.00 | 🛠️ | [`examples/multi-provider-setup.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/multi-provider-setup.ts) |
| **Gemini** | Gemini 2.5 Flash-Lite | $0.10 | $0.40 | 🛠️ | [`examples/multi-provider-setup.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/multi-provider-setup.ts) |
| **Bedrock** | Amazon Nova Micro | $0.035 | $0.14 | 🛠️ | [`examples/bedrock-multi-provider.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/bedrock-multi-provider.ts) |
| **Bedrock** | Amazon Nova Lite | $0.06 | $0.24 | 🛠️ | [`examples/bedrock-multi-provider.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/bedrock-multi-provider.ts) |
| **Bedrock** | Amazon Nova Pro | $0.80 | $3.20 | 🛠️ | [`examples/bedrock-multi-provider.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/bedrock-multi-provider.ts) |
| **Azure OpenAI** | GPT-5 Global Standard | $1.25 | $10.00 | 🛠️ | [`examples/multi-provider-failover.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/multi-provider-failover.ts) |
| **Azure OpenAI** | GPT-5 mini Global Standard | $0.25 | $2.00 | 🛠️ | [`examples/multi-provider-failover.ts`](https://github.com/agentguard-ai/tealtiger/blob/HEAD/examples/multi-provider-failover.ts) |
| **Cohere** | Command A | $2.50 | $10.00 | ❌ | — |
| **Cohere** | Command R+ | $2.50 | $10.00 | ❌ | — |
| **Mistral** | Mistral Large 3 | $0.50 | $1.50 | ❌ | — |
| **Mistral** | Mistral Small 4 | $0.15 | $0.60 | ❌ | — |
| **Mistral** | Mistral Medium 3.5 | $1.50 | $7.50 | ❌ | — |
### Legenda da cobertura
- ✅ — Verificado de ponta a ponta via `observe()` + testado em `test_property_20_cost_monotonicity.py`
- 🟡 — Importado no adaptador `observe()`, ainda sem teste de propriedade
- 🛠️ — Exemplo de adaptador existe, ainda sem integração com `observe()`
- ❌ — Listado apenas em `cost-comparison.md`, ainda sem hook no SDK (PRs são bem-vindos)
--proxy--unique - Use para remover resultados duplicados de saída| Nível | Ponto de Entrada | O que você obtém |
|---|
| 0 | observe(client) | Rastreamento de custos, trilha de auditoria, detecção de PII, linha de base comportamental, interruptor de parada |
| 1 | + guardrails config | Injeção de prompt, moderação de conteúdo, detecção de segredos |
| 2 | + TealEngine policies | ENFORCE/MONITOR/REPORT_ONLY por regra, decisões determinísticas |
| 3 | + TealFlow workflows | Herança de governança de nível organizacional, YAML declarativo |
| Dimensão | O que faz | Módulo |
|---|
| 🛡️ Segurança | Detecção de segredos (500+ padrões), injeção de prompt, PII, moderação de conteúdo, normalização Unicode, detecção de saída codificada | TealSecrets TealGuard |
| 🔑 Identidade | Ciclo de vida de Identidade Não Humana, aplicação de escopo, Privilégio Zero Permanente, atestação de agente | TealEngine (NHI) |
| ⚡ Confiabilidade | Disjuntores, orçamentos de repetição, cadeias de fallback, degradação determinística | TealCircuit TealReliability |
| 🧠 Memória | Proveniência de escrita, detecção de injeção de instruções, prevenção de exfiltração, aplicação de escopo | TealMemory |
| 💰 Custo | Limites de propriedade da governança, detecção de anomalias, orçamentos de tokens de raciocínio, atribuição por agente | TealMonitor |
| 📋 Evidência | Recibos criptográficos (Merkle + RFC 3161), exportação SARIF, spans OTel, integração SIEM | TealProof TealAudit |
| ⚙️ Política | Regras FREEZE, modo PLAN_ONLY, pacotes hot-swap, anti-adulteração, níveis de automação | TealEngine |
| 🔄 Fluxo de Trabalho | Fluxos de trabalho de governança declarativos em YAML, herança em nível de organização, aplicação de piso | TealFlow |
| 📊 Deriva | Detecção de deriva comportamental, linhas de base estatísticas, regressão de saída do modelo | TealDrift |
| ⏱️ Temporal | TTL de sessão, períodos de resfriamento, restrições de horário | TealTemporal |
| 🔍 Registro | Monitoramento de deriva de definição MCP, varredura de descrição de ferramentas, lista de permissão de composição de adaptadores | TealRegistry |
| 🧠 Classificação | Inferência de ML local ONNX (≤20ms), modos ensemble, combinação regex+ML | TealClassifier |
| Idioma | Código Fonte | Pacote | Instalação |
|---|
| TypeScript | tealtiger-typescript-prod | npm | npm install tealtiger |
| Python | tealtiger-python-prod | PyPI | pip install tealtiger |
| Framework | Pacote | Instalação |
|---|
| LangChain | langchain-tealtiger | pip install langchain-tealtiger |
| Vercel AI SDK | tealtiger-ai-sdk | npm install tealtiger-ai-sdk |
| PydanticAI | pydanticai-tealtiger | pip install pydanticai-tealtiger |
| Haystack | haystack-tealtiger | pip install haystack-tealtiger |
| CAMEL-AI | camelai-tealtiger | pip install camelai-tealtiger |
| Plataforma | O que fornece | Instalação |
|---|
| Dakera | Backend de estado de governança persistente (armazenamento de custos, recibos de decisão, cadeias de delegação via KG) | pip install dakera[tealtiger] |
| AG2 Beta | Extensão de middleware de governança para agentes AG2 Beta | pip install ag2-tealtiger |
| Portkey Gateway | Guardrail webhook para Portkey AI Gateway | Example |
| Daytona | Governança pré-execução para execução de código em sandbox | Example |
| Área | Exemplos | Dificuldade |
|---|
| 🔍 Detecção de Segredos | Novos padrões de detecção, categorias personalizadas | 🟢 Iniciante |
| 📝 Documentação | Guias, exemplos, documentação da API, correções de erros de digitação | 🟢 Iniciante |
| 🧪 Testes | Testes unitários, testes baseados em propriedades, testes de integração | 🟡 Intermediário |
| 🔌 Integrações | LangChain, CrewAI, AG2, LlamaIndex middleware | 🟡 Intermediário |
| 💾 Adaptadores de Memória | Redis, Pinecone, Weaviate, ChromaDB adapters | 🟡 Intermediário |
| 🔄 Templates de CI/CD | Jenkins, Azure Pipelines, Bitbucket Pipelines | 🟡 Intermediário |
| 🏗️ Módulos Principais | Motor de governança, exportação de evidências, avaliação de políticas | 🔴 Avançado |