🧠 Azitech Open Source AI Search Assistant

Central de Soluções Digitais com IA Multi-Provedor

Sistema modular que integra múltiplos provedores de IA (Groq, Fireworks, Together, Replicate, Vercel AI Gateway) em uma única interface Streamlit. Oferece desde análise de texto local até geração de código em Python, Rust, C++, consultas SEO e etimologia.

🔗 Acesse o site oficial: azitech.com.br

---

📋 Índice

• Visão Geral
• Arquitetura do Sistema
• Módulos Disponíveis
• Tecnologias Utilizadas
• Pré-requisitos
• Instalação e Execução
• Como Obter Chaves de API
• Estrutura de Pastas

---

🚀 Visão Geral

O Azitech AI Search Assistant é uma plataforma unificada que permite acessar dezenas de modelos de IA através de um único ponto de entrada, com fallback automático entre provedores. Ideal para:

• Profissionais de SEO que precisam de auditorias técnicas e sugestões de otimização.
• Desenvolvedores que desejam gerar código em múltiplas linguagens.
• Pesquisadores e curiosos que querem explorar etimologia e cálculos.
• Empresas que buscam independência de provedor e otimização de custos.

---

🏗️ Arquitetura do Sistema

O sistema é composto por:

1. Router Inteligente (router.py)
   Gerencia chamadas para múltiplos provedores (Groq, Fireworks, Together, Replicate, Vercel) com fallback automático. Se um provedor falhar (cota excedida, instabilidade), a requisição é redirecionada para o próximo disponível.

2. Módulos Especializados
   Cada funcionalidade é isolada em um módulo independente dentro da pasta modules/. Todos utilizam o router para comunicação com a IA.

3. Interface Streamlit (app.py)
   Interface gráfica moderna, responsiva e totalmente personalizada com a identidade visual da AZITech.

4. Analisador Core (analisador_core.py)
   Funcionalidades locais sem IA: extração de headings, metadados, análise de sentimento, palavras-chave, leitura de PDF, etc.

---

📦 Módulos Disponíveis

Módulo	Arquivo	Descrição
Analisador Core	analisador_core.py	Análise de texto, PDF, headings e metadados (totalmente local, sem IA).
Assistente SEO	search_assistant.py	Chat especializado em SEO, estratégias de ranqueamento e otimização de conteúdo. Baseado nas diretrizes oficiais do Google Search Central.
Código Python	code_assistant.py	Gera código Python a partir de descrições, com explicação, exemplo e LaTeX.
Rust (Cálculo)	rust_calc_assistant.py	Gera código Rust para problemas matemáticos e numéricos, com exemplos usando números inteiros (prova real).
C++ (Cálculo)	cpp_calc_assistant.py	Gera código C++ para cálculos, com exemplos usando números inteiros (prova real).
Etimologia	etimologia.py	Consulta a origem de palavras em latim, grego, sânscrito, hebraico, etc. Baseado em dicionários etimológicos e referências acadêmicas.

---

🛠️ Tecnologias Utilizadas

• Linguagem: Python 3.10+
• Framework Web: Streamlit
• Provedores de IA:
  • Groq
  • Fireworks AI
  • Together AI
  • Replicate
  • Vercel AI Gateway (compatível com OpenAI)
• Bibliotecas principais:
  • PyPDF2 – extração de texto de PDFs
  • requests + beautifulsoup4 – scraping de headings e metadados
  • openai – cliente base para APIs compatíveis
  • groq, fireworks-ai, together, replicate – SDKs oficiais
  • python-dotenv – gerenciamento de variáveis de ambiente

---

✅ Pré-requisitos

• Python 3.10 ou superior instalado.
• Git (para clonar o repositório).
• Chaves de API de pelo menos um dos provedores suportados (recomenda-se ter várias para fallback).

---

🔧 Instalação e Execução

1. Clone o repositório

git clone https://github.com/Gussnogue/azitech_open_source_ai_search_assistant.git
cd azitech_open_source_ai_search_assistant

---

2. Crie e ative um ambiente virtual

Windows:

python -m venv venv
venv\Scripts\activate

Linux/macOS:

python3 -m venv venv
source venv/bin/activate

3. Instale as dependências

pip install -r requirements.txt

4. Configure as chaves de API (opcional)

Crie um arquivo .env na raiz do projeto com suas chaves:

GROQ_API_KEY=sua_chave
FIREWORKS_API_KEY=sua_chave
TOGETHER_API_KEY=sua_chave
REPLICATE_API_TOKEN=sua_chave
VERCEL_AI_GATEWAY_KEY=sua_chave

Ou insira as chaves diretamente na interface do Streamlit após executar o app.

5. Execute o aplicativo

streamlit run app.py

O aplicativo abrirá automaticamente no navegador em http://localhost:8501

🔑 Como Obter Chaves de API

Provedor	URL para cadastro	plano gratuito
Groq	console.groq.com	✅ Sim (30 req/min)
Fireworks AI	fireworks.ai	✅ Sim (créditos iniciais)
Together AI	together.ai	✅ Sim (créditos iniciais)
Replicate	replicate.com	✅ Sim (créditos iniciais)
Vercel AI	Gateway vercel.com/ai-gateway	✅ freemium

📁 Estrutura de Pastas

azitech_open_source_ai_search_assistant/
├── app.py                     # Interface Streamlit (frontend principal)
├── requirements.txt           # Dependências do projeto
├── README.md                  # Documentação
├── .env.example               # Exemplo de arquivo de ambiente
├── .gitignore                 # Arquivos ignorados pelo Git
└── modules/
    ├── __init__.py            # Torna a pasta um pacote Python
    ├── analisador_core.py     # Módulo local (sem IA)
    ├── search_assistant.py    # Assistente SEO
    ├── code_assistant.py      # Assistente Python
    ├── rust_calc_assistant.py # Assistente Rust
    ├── cpp_calc_assistant.py  # Assistente C++
    ├── etimologia.py          # Consulta etimológica
    └── router.py              # Roteador inteligente multi-provedor

Contato: azitech.oficial@gmail.com | @azi.tech.math

Gustavo Silva Nogueira