py-ai-api-integration

Cliente Python orientado a objetos para integração e testes de APIs de IA, com foco inicial em DeepSeek, persistência de dados em SQLite e configuração flexível via YAML.

Status: Beta — funcional para DeepSeek, em evolução para múltiplos provedores e integração futura com Telegram.

Funcionalidades

• Integração com API DeepSeek (outros provedores em desenvolvimento)
• Persistência de uso em SQLite
• Configuração via YAML (src/config/settings.yaml)
• Logging estruturado
• Tipagem completa

Instalação

Usando uv (recomendado)

uv venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows
uv sync

Usando pip

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows
pip install -r requirements.txt  # ou instale manualmente as dependências

Configuração e Uso

Copie o arquivo de exemplo e edite com sua chave:

cp .env.example .env

No arquivo .env:

DEEPSEEK_API_KEY=seu_token_aqui

Ajuste parâmetros em src/config/settings.yaml conforme necessário.

Execute a aplicação principal:

uv run python main.py

Próximos Passos

• Validação de suporte para todas as providers
• Testes unitários e de integração
• Melhoria da documentação de persistencia de dados
• Implementações usando Jupyter
• Dividir responsabilidades em módulos separados (utilitários)
• Querys separadas em arquivos .sql para melhor organização

Contato

GitHub: pagueru

LinkedIn: Raphael Coelho

E-mail: raphael.phael@gmail.com