Um veredito por matéria

O Supaco lê suas faltas direto na API do SUAP e aplica a regra dos 25% do IFRN. Cada matéria cai em um destes cinco:

Aponte a câmera do celular

Instalar no Android Baixe o supaco.apk pelo celular. Permita a instalação quando o Android pedir. É o aviso padrão para apps fora da Play Store. Entre com a matrícula e a senha do SUAP. A senha fica criptografada só no aparelho. O app fala apenas com suap.ifrn.edu.br, sem anúncios nem rastreadores.

O ecossistema

Supaco Mobile Kotlin · Jetpack Compose Veredito do dia, widgets, atalho no painel rápido, alertas antes do limite e modo offline. Código · Releases	Supaco CLI Go · Bubble Tea Aulas de hoje, grade da semana, frequência, notas e notificações sem sair do terminal. Código · yay -S supaco-cli
Supaco Web React · Electron · Gemini Painel no navegador e app desktop, com assistente que conhece suas notas e o Google Sala de Aula. Código · supaco.vercel.app	SuaPy Python 3.10+ Biblioteca e CLI para boletim, faltas, horários e avaliações, com exportação para CSV, JSON e Pandas. Código · Documentação

Comandos de instalação

# Supaco CLI
yay -S supaco-cli                                   # Arch, Manjaro, CachyOS
go install github.com/kellyson71/supaco-cli@latest  # qualquer sistema com Go

# SuaPy
pip install suapy

from suapy import Suap

with Suap() as suap:
    suap.login(matricula, senha)
    boletim = suap.ensino.obter_boletim(2026, 1)
    for d in suap.iterar_resultados(boletim):
        print(d["disciplina"], d["numero_faltas"])

Como os APKs chegam nas releases

O workflow apk.yml confere as releases do supaco-mobile a cada três horas. Cada versão nova vira uma release aqui, com o mesmo número, contendo:

• o APK original
• supaco.apk, uma cópia com nome fixo
• o .sha256 para conferir o arquivo

Por causa do nome fixo, este link sempre baixa a versão mais nova:

https://github.com/kellyson71/supaco/releases/latest/download/supaco.apk

Para espelhar na hora, rode o workflow pela aba Actions.

Organização deste repositório

Este é o hub do Supaco. O código de cada produto vive no próprio repositório e entra aqui como submódulo.

supaco/
├── site/        landing page (Vite, React, Tailwind, framer-motion)
├── projetos/    supaco-mobile, supaco-cli, supaco-web e suapy (submódulos)
├── docs/        imagens deste README
└── .github/     deploy do site e espelho dos APKs

git clone --recurse-submodules https://github.com/kellyson71/supaco.git
git submodule update --remote --merge   # atualiza todos os projetos

Rodar o site

cd site
npm install
npm run dev     # http://localhost:5173

?f=0 até ?f=12 na URL abre o topo em um veredito específico. Todo push em main que mexe em site/ publica no GitHub Pages.

_{Projeto não oficial, feito por estudante, sem vínculo com o IFRN.
MIT · Kellyson}