convez.ai
MCP ServerProdutividadeIntermediário
kaorii-ako

Shiori - Companheiro de Estudos com IA

kaorii-ako/Shiori-v1

Plataforma de estudo com IA, rastreamento de notas e gamificação

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server open-source que oferece um companion de estudo completo alimentado por Gemini AI. Integra sincronização com Google Classroom, gerador de quizzes, flashcards com repetição espaçada, preditor de GPA e planejamento de estudos automatizado. Pronto para autopublicação em 5 minutos, sem dependências de assinatura.

Instalação

$npx convez-ai kaorii-ako/Shiori-v1

1 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

Estrelas
48
Forks
5
Acompanhando
0
Saúde
100%
Último commit
há 3 meses
Versão
v2.2.0
Issues abertas
6
Contribuidores
1

Casos de uso

  • Gerar quizzes e flashcards automaticamente a partir de anotações
  • Sincronizar tarefas do Google Classroom e rastrear prazos
  • Prever notas finais e otimizar planejamento de estudos com IA
  • Acompanhar hábitos de estudo com timer Pomodoro e análise de progresso

Veredito

Ferramenta robusta e bem-pensada para gestão acadêmica integrada com IA. A implementação como MCP server é prática, mas o foco principal é a UI web; valioso para estudantes sérios que querem automação inteligente sem fricção de assinaturas.

README

A tradução para o português deste README ainda está na fila.

栞 Shiori

The AI-powered study companion for serious students.

GitHub stars License: MIT Live Demo CI

🎮 Try Demo · 📖 Docs · 🐛 Report Bug · 💡 Request Feature


What is Shiori?

Shiori (栞, bookmark in Japanese) is an open-source AI study companion built for students who take their grades seriously. It combines AI-powered study tools, gamification, and productivity features into one beautiful dark-mode app.

No subscription required for core features. Bring your own free Gemini API key. Self-hostable in 5 minutes.

🎮 Try the live demo — no account, no API key needed.


✨ Features

FeatureDescription
🤖 AI Quiz GeneratorGenerate MCQ quizzes from your notes with Gemini AI
🃏 AI FlashcardsAuto-generate spaced repetition flashcard decks
📊 Grade TrackerWeighted grade calculator with GPA predictor
📅 Assignment ManagerDue dates, priorities, completion tracking
📝 Markdown NotesTwo-panel editor with live preview
🎯 Focus ModePomodoro timer with task linking
🏆 LeaderboardCompare XP and streaks with friends
📈 AnalyticsStudy time, grade trends, completion rates
🌱 Habit TrackerDaily habit streaks with completion heatmap
🗓 Study PlansAI-generated day-by-day study schedules
📚 Syllabus ImportParse syllabi to auto-create assignments
⌨️ Keyboard ShortcutsPower-user navigation (gh, ga, gn, gq...)
🎮 GamificationXP system, levels (Freshman → Graduate), achievements

🚀 Quick Start

Option 1: Live demo (no setup)

👉 shiori-v1.vercel.app/demo

No account. No API key. Full experience.

Option 2: Deploy to Vercel (1 click)

Deploy with Vercel

Option 3: Self-host locally

Prerequisites: Node.js 18+, free Supabase account, free Gemini API key

# Clone
git clone https://github.com/kaorii-ako/Shiori-v1.git
cd Shiori-v1

# Configure
cp .env.example .env
# Edit .env with your Supabase URL + anon key

# Run Supabase schema
# → Open supabase/schema.sql in your Supabase SQL Editor and run it

# Install + start
npm install
npm run dev

Open http://localhost:5173 → click Try Demo or sign up.

Environment Variables

VariableRequiredWhere to get
VITE_SUPABASE_URL✅ Yessupabase.com → Settings → API
VITE_SUPABASE_ANON_KEY✅ Yessupabase.com → Settings → API
VITE_GEMINI_API_KEYOptionalaistudio.google.com/apikey (free)

🏗 Tech Stack

Frontend:   React 18 + Vite + Zustand
Database:   Supabase (PostgreSQL + Auth)
AI:         Google Gemini 1.5 Flash (client-side, BYOK)
Deployment: Vercel

⌨️ Keyboard Shortcuts

ShortcutAction
g hGo to Home
g aGo to Assignments
g nGo to Notes
g fGo to Flashcards
g qGo to Quiz
g gGo to Grades
?Show all shortcuts

📁 Project Structure

Shiori-v1/
├── client/               # React + Vite frontend
│   └── src/
│       ├── pages/        # 16 pages (Home, Assignments, Grades, Notes...)
│       ├── components/   # Shared components (Sidebar, GlassCard, AIChat...)
│       ├── stores/       # Zustand state management
│       ├── utils/        # theme.js, gemini.js, demoData.js
│       └── lib/          # supabase.js, db.js
├── server/               # Express.js backend (optional, for Stripe webhooks)
├── extension/            # Chrome MV3 extension
├── supabase/             # Database schema + setup guide
└── docs/                 # Screenshots, specs

🤝 Contributing

Contributions are welcome! Shiori is built by students for students.

  1. Check good first issues
  2. Read CONTRIBUTING.md
  3. Fork → branch → PR

📄 License

MIT — free for personal and commercial use.


Made with ❤️ by Tawin Tangsukson

If Shiori helps you study better, please consider giving it a ⭐ — it means a lot!

Ver o original no GitHub

Bom para

Relacionados