AdaptAI

EN: AdaptAI is an AI-assisted educational inclusion prototype that helps teachers adapt class materials and assessments for students with special educational needs.

PT: O AdaptAI é um protótipo de inclusão educacional com IA que ajuda professores a adaptar materiais e avaliações para estudantes com necessidades educacionais especiais.

Purpose | Propósito

EN

• Support teachers in inclusive pedagogy workflows.
• Convert raw instructional content into practical adaptation guidance.
• Preserve pedagogical intent while adapting accessibility, language, and evaluation format.

PT

• Apoiar professores em fluxos de pedagogia inclusiva.
• Converter conteúdo didático bruto em orientação prática de adaptação.
• Preservar a intenção pedagógica ao adaptar acessibilidade, linguagem e formato de avaliação.

Main Flow | Fluxo Principal

1) Home / Início

EN: Landing page introduces the platform mission and the teacher journey.

PT: A página inicial apresenta a missão da plataforma e a jornada do professor.

2) Suggestions Form / Formulário de Sugestões

EN: Teacher provides discipline, education level, student needs, and material (upload or pasted text).

PT: O professor informa disciplina, nível de ensino, necessidades do aluno e material (upload ou texto colado).

3) Suggestions Result (Sample) / Resultado de Sugestões (Exemplo)

EN: Structured adaptation recommendations (how to adapt, expected difficulties, teaching strategies, support resources, adapted assessment).

PT: Recomendações estruturadas de adaptação (como adaptar, dificuldades esperadas, estratégias de ensino, recursos auxiliares e avaliação adaptada).

4) Adapted Test Form / Formulário de Prova Adaptada

EN: Teacher adds one or more original questions and optional expected answers.

PT: O professor adiciona uma ou mais questões originais e respostas esperadas opcionais.

5) Adapted Test Result (Sample) / Resultado de Prova Adaptada (Exemplo)

EN: Output includes adapted question versions plus explanation of each adaptation. Focused close-up below highlights the generated assignment content.

PT: A saída inclui versões adaptadas das questões e explicação de cada adaptação. A captura em close abaixo destaca o conteúdo da prova gerada.

Features | Funcionalidades

EN

• Multi-page Streamlit interface.
• Material ingestion from PDF, DOCX, and plain text.
• Inclusive adaptation recommendations by context.
• Adapted test generation preserving learning objectives.

PT

• Interface Streamlit multipágina.
• Ingestão de material em PDF, DOCX e texto simples.
• Recomendações de adaptação inclusiva por contexto.
• Geração de prova adaptada preservando objetivos de aprendizagem.

Tech Stack

• Python
• Streamlit
• Agno agent framework
• OpenAI models
• Pydantic structured outputs
• PyPDF2 + python-docx

Quick Start | Como Executar

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
streamlit run Home.py

Create a .env file (or set environment variable) with:

OPENAI_API_KEY=your_key_here

Notes on Screenshots | Observações sobre Capturas

EN: Form screenshots are real captures from the running app. Result screenshots are sample visual cards reconstructed from archived outputs in archive/*.md to document the expected flow without requiring a live API run.

PT: As capturas de formulário são reais, feitas com o app em execução. As capturas de resultado são cartões visuais de exemplo reconstruídos a partir de saídas arquivadas em archive/*.md, para documentar o fluxo esperado sem exigir execução com API ao vivo.

Re-capturing Screenshots | Refazendo Capturas

source .venv/bin/activate
pip install playwright
python -m playwright install chromium
streamlit run Home.py --server.headless true --server.port 8501
python scripts/capture_screenshots.py

Repository Layout | Estrutura do Repositório

Home.py
pages/
  1_☝️_Sugestoes.py
  2_📋_Elaboracao.py
library/
  adaptator_agent/
  essay_agent/
archive/
docs/screenshots/
img/