🧠 Mateo SDK — no formato das grandes IAs

O Mateo é uma IA generativa para o ensino: um colega de estudos que responde por ele mesmo (memória + conhecimento), sem depender de modelos externos. Este SDK segue o mesmo padrão dos SDKs que você já conhece:

Instalação

pip install -e ./sdk            # a partir do repositório
# ou direto do git:
# pip install "git+https://github.com/intelliski/mateo.git#subdirectory=sdk"

Uso rápido

from mateoai import Mateo

mateo = Mateo(api_key="sua-chave")

# 1) Formato das grandes IAs (OpenAI-compatível):
resposta = mateo.chat.completions.create(
    model="mateo-1",
    messages=[{"role": "user", "content": "o que é fração?"}],
)
print(resposta.choices[0].message.content)

# 2) Atalho — pergunta única:
print(mateo.chat("explique a fotossíntese"))

# 3) Streaming (experiência ChatGPT):
for pedaco in mateo.chat.completions.create(
    model="mateo-1",
    messages=[{"role": "user", "content": "monte um plano de estudos de inglês"}],
    stream=True,
):
    if pedaco.choices and pedaco.choices[0].delta.content:
        print(pedaco.choices[0].delta.content, end="", flush=True)

# 4) Estado do servidor:
print(mateo.health())

Cliente assíncrono

import asyncio
from mateoai import MateoAsync

async def main():
    mateo = MateoAsync(api_key="sua-chave")
    resposta = await mateo.chat.completions.create(
        model="mateo-1",
        messages=[{"role": "user", "content": "o que é fração?"}],
    )
    print(resposta.choices[0].message.content)

asyncio.run(main())

Referência

Testes: python -m pytest sdk/tests (ou python sdk/tests/test_mateoai.py).

Compatibilidade: from mateo_sdk import MateoClient continua funcionando (alias para Mateo).

Autenticação: Authorization: Bearer <chave> (feita automaticamente pelo SDK). A chave também pode vir da variável de ambiente MATEO_API_KEY.

Obtendo uma chave

Chaves de API são geradas pelo dono do Mateo no painel administrativo (aba "Chaves da API", em /#admin do webapp). Cada chave é exibida apenas no momento da criação — guarde-a em local seguro. Para revogar, basta excluí-la no painel: ela para de funcionar imediatamente.

Documentação completa da API: frontend/web/docs.html (ou a página "API" da landing page em produção).