Metadata-Version: 2.4
Name: kob
Version: 0.0.2
Summary: SDK Python para abstrair a configuração de agentes de IA em uma única classe
Project-URL: Homepage, https://github.com/ygorPaulo074/kob
Project-URL: Repository, https://github.com/ygorPaulo074/kob
Author: Paulo Ygor Oliveira Araújo
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Requires-Dist: tomli>=2.0; python_version < '3.11'
Description-Content-Type: text/markdown

# kob

SDK Python open source que encapsula a complexidade da construção de um agente de IA em métodos simples e intuitivos.

> Status: em design, ainda não implementado.

## Client

A SDK oferece uma classe com os principais métodos. O tratamento de assincronicidade é feito por um valor booleano, que quando positivo, ativa um tratamento assíncrono em todos os métodos da classe.

## Configuração

A configuração é externa, via arquivo dedicado `agent.toml`. Segue abaixo exemplo da estrutura do TOML:

```toml
# agent.toml
model = "..."
api_key_env = "KOB_API_KEY"
```

### Cadeia de resolução, por campo de config

Cada valor de configuração é resolvido nesta ordem de prioridade:

1. **Argumento explícito** no construtor (`Agent(model="...")`) — maior prioridade.
2. **`agent.toml`**.
3. **Variável de ambiente**.
4. Se nenhuma das três fontes tiver o valor → erro explícito.

### Modo debug

Para execução em modo debug, deve-se ativar no arquivo `.env` o booleano `DEBUG`.

## Em aberto

- Regra de parada da busca de diretório do `agent.toml` (subir até a raiz do filesystem vs. parar em um marcador tipo `.git`).
- Superfície pública final — métodos concretos do agente.
