NeuroLearn - Plataforma de Aprendizado Personalizado com IA
Chocoberry1108/NeuroLearn
Converta qualquer tópico em cursos personalizados com IA generativa
Ver no GitHubNeuroLearn é uma plataforma de aprendizado adaptativo baseada em IA que converte qualquer tópico ou documento em cursos dinâmicos e personalizados. Oferece geração automática de trilhas de aprendizado, conversão de PDFs em conteúdo estruturado, tutoria virtual 24/7 e gamificação com sistema de streaks e XP para manter o engajamento.
Instalação
npx convez-ai Chocoberry1108/NeuroLearn1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar cursos autodidatas a partir de palavras-chave ou documentos
- Ter um tutor virtual disponível para dúvidas durante o aprendizado
- Manter motivação com gamificação e rastreamento de progresso diário
Veredito

NeuroLearn é uma solução robusta para aprendizado personalizado que integra bem o Gemini API e oferece UX moderna. Embora o repositório seja original, foca em educação e produtividade pessoal mais que em integração com ecossistemas de IA existentes como Claude.
README
A tradução para o português deste README ainda está na fila.
🧠 NeuroLearn AI - Hệ Sinh Thái Học Tập Thích Ứng Cá Nhân Hóa

NeuroLearn AI là một nền tảng học tập đột phá được hỗ trợ bởi trí tuệ nhân tạo (AI), cho phép người dùng tự kiến tạo lộ trình tri thức của riêng mình. Thay vì học theo các giáo trình cố định, NeuroLearn AI biến mọi chủ đề hoặc tài liệu thô thành các khóa học sinh động, cá nhân hóa hoàn toàn cho từng cá nhân.
✨ Tính Năng Nổi Bật
- 🚀 AI Course Generator: Tạo lộ trình học tập toàn diện (gồm các chương và bài học chi tiết) chỉ từ một từ khóa hoặc ý tưởng.
- 📄 Document-to-Course: Tải lên tệp PDF hoặc hình ảnh bài giảng để AI tự động chuyển đổi thành nội dung học tập có cấu trúc.
- 🤖 Neuro AI Tutor: Gia sư ảo trực tuyến 24/7, sẵn sàng giải đáp mọi thắc mắc và giải thích các khái niệm phức tạp trong bài học.
- 🎮 Gamification: Hệ thống theo dõi Streak (chuỗi ngày học), tích lũy XP và điểm thưởng để duy trì động lực học tập mỗi ngày.
- 📱 Mobile-First Design: Giao diện hiện đại, mượt mà, tối ưu hóa cho trải nghiệm trên thiết bị di động với hỗ trợ Chế độ tối (Dark Mode).
🛠️ Công Nghệ Sử Dụng
- Frontend: React 19, TypeScript, Tailwind CSS.
- Build Tool: Vite.
- AI Engine: Google Gemini API (
@google/genai). - Icons: Lucide React.
- Animations: Framer Motion.
🚀 Hướng Dẫn Cài Đặt & Triển Khai (Deployment)
1. Yêu Cầu Hệ Thống
- Node.js (v18.x trở lên)
- NPM hoặc Yarn
2. Cài Đặt
Tải mã nguồn về máy và cài đặt các thư viện phụ thuộc:
npm install
3. Cấu Hình Biến Môi Trường
Tạo tệp .env tại thư mục gốc và thêm khóa API của Google Gemini:
VITE_GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE
Lưu ý: Bạn có thể lấy API Key miễn phí tại Google AI Studio.
4. Chạy Ở Chế Độ Phát Triển (Development)
npm run dev
Ứng dụng sẽ chạy tại địa chỉ: http://localhost:3000
5. Đóng Gói & Triển Khai (Production)
Để tạo bản build tối ưu cho môi trường thực tế:
npm run build
Các tệp tin tĩnh sẽ được tạo trong thư mục dist/. Bạn có thể triển khai thư mục này lên các nền tảng như:
- Vercel / Netlify: Chỉ cần kết nối với kho lưu trữ GitHub.
- Cloud Run / Docker: Sử dụng Dockerfile để đóng gói và chạy trên Google Cloud.
📝 Giấy Phép
Dự án được phát triển cho mục đích giáo dục và tham gia cuộc thi Sáng tạo.
Phát triển bởi Đội ngũ NeuroLearn AI 🚀