Stack Tecnológica e Ferramentas
Última atualização em 07/06/2026
Core da Aplicação
| Ferramenta |
Versão |
Contexto no Vox AI |
Docs Oficiais |
| Python |
3.13 |
Linguagem principal do projeto inteiro |
docs.python.org/3.13 |
| Streamlit |
1.52.2 |
Framework da interface web (chat, sidebar, botões, estado de sessão) |
docs.streamlit.io |
| uv |
latest |
Gerenciador de pacotes e ambientes virtuais ultrarrápido (substitui pip+venv) |
docs.astral.sh/uv |
| gTTS |
2.5.4 |
Text-to-Speech: converte respostas em áudio MP3 com voz pt-BR |
gtts.readthedocs.io |
| python-dotenv |
1.2.1 |
Carregamento de variáveis de ambiente para desenvolvimento local |
pypi.org/project/python-dotenv |
Inteligência Artificial
| Ferramenta |
Contexto no Vox AI |
Docs Oficiais |
| Google GenAI SDK (google-genai) |
Biblioteca oficial para acessar a API do Gemini. Usada para gerar respostas (LLM) e embeddings (RAG) |
ai.google.dev/gemini-api/docs |
| Gemini Flash (gemini-3.5-flash) |
Modelo LLM principal. Recebe o system prompt + contexto RAG e gera as respostas em streaming |
ai.google.dev/gemini-api/docs/models |
| Gemini Flash Lite (gemini-3.1-flash-lite) |
Modelo LLM leve utilizado no Gatekeeper para revisões automáticas de segurança de código |
ai.google.dev/gemini-api/docs/models |
| Gemini Embeddings (gemini-embedding-001) |
Modelo de embeddings. Converte textos em vetores de 1536 dimensões para busca semântica |
ai.google.dev/gemini-api/docs/embeddings |
Banco de Dados
| Ferramenta |
Contexto no Vox AI |
Docs Oficiais |
| Supabase |
Backend-as-a-Service completo: PostgreSQL, API REST automática, RLS, SDK Python e dashboard |
supabase.com/docs |
| PostgreSQL 17 |
Banco relacional onde ficam todas as tabelas, funções, triggers e índices |
postgresql.org/docs |
| pgvector (extensão vector) |
Adiciona o tipo vector, operador de distância cosseno (<=>) e índices HNSW para busca semântica |
github.com/pgvector/pgvector |
| Supabase CLI |
Gerencia o projeto localmente, gera e aplica migrations via db diff/push |
supabase.com/docs/guides/cli |
DevOps e CI/CD
| Ferramenta |
Contexto no Vox AI |
Docs Oficiais |
| GitHub Actions |
Plataforma de CI/CD. Orquestra os 9 workflows: testes, releases, deploys e seguranca |
docs.github.com/actions |
| Git Cliff (git-cliff) |
Gerador de CHANGELOG.md automático a partir de Conventional Commits e tags Git |
git-cliff.org/docs |
| Pytest |
Framework de testes Python. Roda testes unitários e de integração no pipeline |
docs.pytest |
| Hugging Face Spaces |
Plataforma de deploy alternativa (mirror). App Streamlit sincronizado após cada release |
huggingface.co/docs/hub/spaces |
| GitHub Pages |
Hospedagem estática do Dashboard de transparencia pública |
docs.github.com/pages |