{"id":29436208,"url":"https://github.com/chaosweasl/cognify","last_synced_at":"2025-07-13T05:02:48.353Z","repository":{"id":298914144,"uuid":"1001530210","full_name":"chaosweasl/cognify","owner":"chaosweasl","description":"A website with an AI assistant that can turn notes into flashcards, and also remind the user to study through spaced repetition.","archived":false,"fork":false,"pushed_at":"2025-07-11T15:53:04.000Z","size":2216,"stargazers_count":4,"open_issues_count":8,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-11T17:54:11.929Z","etag":null,"topics":["contributions-welcome","daisyui","daisyui-react","eslint","help-wanted","javascript","nextjs","open-source","productivity","productivity-tools","react","redux","student","student-tools","study","supabase","typescript","web","website"],"latest_commit_sha":null,"homepage":"https://cognify-chaosweasl.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chaosweasl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-13T14:37:33.000Z","updated_at":"2025-07-11T15:51:29.000Z","dependencies_parsed_at":"2025-06-13T15:48:13.879Z","dependency_job_id":"313361c4-b5a0-4136-bd5f-79af4a5992f6","html_url":"https://github.com/chaosweasl/cognify","commit_stats":null,"previous_names":["chaosweasl/paideia","chaosweasl/cognify"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chaosweasl/cognify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaosweasl%2Fcognify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaosweasl%2Fcognify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaosweasl%2Fcognify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaosweasl%2Fcognify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chaosweasl","download_url":"https://codeload.github.com/chaosweasl/cognify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chaosweasl%2Fcognify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265091726,"owners_count":23710031,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contributions-welcome","daisyui","daisyui-react","eslint","help-wanted","javascript","nextjs","open-source","productivity","productivity-tools","react","redux","student","student-tools","study","supabase","typescript","web","website"],"created_at":"2025-07-13T05:01:31.357Z","updated_at":"2025-07-13T05:02:48.338Z","avatar_url":"https://github.com/chaosweasl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cognify\n\n**Cognify** is an open-source platform that helps you turn your notes into flashcards using AI, and reminds you to restudy them using spaced repetition. You control your data and your AI: bring your own API key.\n\n## Features\n\n- ✨ **AI-Powered Flashcard Generation**: Automatically extract key concepts from your notes and generate targeted flashcards.\n- 📄 **Multiple Input Formats**: Upload text, paste content, or upload PDF files.\n- 🗄️ **Personal Study Database**: All flashcards are stored securely for your account.\n- 🔑 **Your Own API**: Use your own AI API key (OpenAI, etc.) for privacy and control.\n- ⏰ **Spaced Repetition Reminders**: Get reminders to review your flashcards for optimal learning.\n- 🔒 **Open Source \u0026 Self-Hostable**: 100% open-source, no vendor lock-in, no hidden fees.\n- 🛡️ **User Authentication**: Secure sign-up, login, and user management.\n- 🖼️ **User Profiles**: Upload profile pictures, change usernames, and manage your account.\n- 🌐 **OAuth Support**: Sign in with Google, GitHub, and more.\n\n## Getting Started\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (v18+ recommended)\n- [npm](https://www.npmjs.com/) or [yarn](https://yarnpkg.com/) or [pnpm](https://pnpm.io/) (for package management)\n- [Supabase](https://supabase.com/) account (for authentication and database)\n- An AI API key (e.g., OpenAI). You can also test with a local model using LMStudio or any other local AI (not recommended for actually creating flashcards)\n\n### Installation\n\n1. **Clone the repository:**\n\n   ```sh\n   git clone https://github.com/chaosweasl/cognify.git\n   cd cognify\n   ```\n\n2. **Install dependencies:**\n\n   ```sh\n   npm install\n   # or\n   yarn install\n   # or\n   pnpm install\n   ```\n\n3. **Set up environment variables:**\n\n   Create a `.env.local` file in the root directory:\n\n   ```\n   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url\n   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key\n   NEXT_PUBLIC_SITE_URL=http://localhost:3000\n   # Or set to your deployed URL if not running locally\n   # Add your AI API key as needed\n   ```\n\n   \u003e **Note:**  \n   \u003e Do **not** use `https://cognify-chaosweasl.vercel.app` unless you are deploying to the official instance.  \n   \u003e Use your own local or deployment URL for `NEXT_PUBLIC_SITE_URL`.\n\n4. **Run the development server:**\n\n   ```sh\n   npm run dev\n   # or\n   yarn dev\n   # or\n   pnpm dev\n   ```\n\n5. **Update Supabase Authentication Settings:**\n\n   In your [Supabase](https://supabase.com/) project dashboard, go to **Authentication → URL Configuration**.  \n   Set the **Site URL** to `http://localhost:3000` (or the URL you use for local testing).  \n   This ensures authentication redirects work correctly during development.\n\n6. **Open [http://localhost:3000](http://localhost:3000) in your browser.**\n\n## Project Structure\n\n```\napp/                # Next.js app directory (routes, pages, layouts)\ncomponents/         # React components\nutils/              # Utility functions (Supabase client, helpers)\npublic/             # Static assets\ndocs/               # Documentation and TODOs\n```\n\n## Roadmap\n\n- [x] Email/password authentication\n- [ ] OAuth login (Google, GitHub, etc.)\n- [ ] User profile management (avatars, usernames)\n- [ ] Flashcard creation and storage\n- [ ] AI-powered flashcard generation (bring your own API key)\n- [ ] PDF parsing and import\n- [ ] Spaced repetition reminders\n- [ ] Mobile-friendly UI\n- [ ] Community/shared decks\n\nSee [`docs/todo.md`](docs/todo.md) for more details.\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md) for guidelines and tutorials on how to contribute.\n\n## License\n\n[MIT](LICENSE)\n\n---\n\n**Cognify** is built to empower learners everywhere. You own your data, your AI, and your learning journey.\n\nYou can watch live development at [https://cognify-chaosweasl.vercel.app/](https://cognify-chaosweasl.vercel.app/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaosweasl%2Fcognify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchaosweasl%2Fcognify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaosweasl%2Fcognify/lists"}