{"id":31725533,"url":"https://github.com/ajor-saha/deltacoders-final-test","last_synced_at":"2026-05-05T19:32:48.068Z","repository":{"id":317750603,"uuid":"1061622429","full_name":"Ajor-Saha/DeltaCoders-Final-Test","owner":"Ajor-Saha","description":"A project for Hackathon","archived":false,"fork":false,"pushed_at":"2025-10-02T19:08:47.000Z","size":2626,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-02T21:10:51.902Z","etag":null,"topics":["ai-agent","express","fullstack-development","gemini-api","nextjs","pinecone","postgresql","smythos"],"latest_commit_sha":null,"homepage":"https://study-flow.taskforges.com/home","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ajor-Saha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-22T07:02:15.000Z","updated_at":"2025-10-02T19:08:51.000Z","dependencies_parsed_at":"2025-10-02T21:21:29.960Z","dependency_job_id":null,"html_url":"https://github.com/Ajor-Saha/DeltaCoders-Final-Test","commit_stats":null,"previous_names":["ajor-saha/deltacoders-final-test"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Ajor-Saha/DeltaCoders-Final-Test","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajor-Saha%2FDeltaCoders-Final-Test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajor-Saha%2FDeltaCoders-Final-Test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajor-Saha%2FDeltaCoders-Final-Test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajor-Saha%2FDeltaCoders-Final-Test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ajor-Saha","download_url":"https://codeload.github.com/Ajor-Saha/DeltaCoders-Final-Test/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ajor-Saha%2FDeltaCoders-Final-Test/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000747,"owners_count":26082932,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ai-agent","express","fullstack-development","gemini-api","nextjs","pinecone","postgresql","smythos"],"created_at":"2025-10-09T05:49:26.519Z","updated_at":"2026-05-05T19:32:48.059Z","avatar_url":"https://github.com/Ajor-Saha.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StudyFlow - AI-Powered Educational Learning Platform\n\n- [1. 📖 Introduction](#1--introduction)\n- [2. 🎯 Problem Statement](#2--problem-statement)\n- [3. 🚀 Live Demo](#3--live-demo)\n- [4. 🎬 Live Video Demonstration](#4--live-video-demonstration)\n- [5. ✨ Key Features](#5--key-features)\n- [6. 🛠️ Technical Stack](#6--technical-stack)\n- [7. 📦 Installation](#7--installation)\n- [8. 📁 Project Structure](#8--project-structure)\n- [9. 🤝 Contributing](#9--contributing)\n- [10. 📄 License](#10--license)\n- [11. 🙏 Acknowledgments](#11--acknowledgments)\n\n---\n\n## 1. 📖 Introduction\n\nStudyFlow is an innovative AI-powered educational platform that revolutionizes the way students learn and educators teach. By leveraging cutting-edge artificial intelligence, we create personalized learning experiences that adapt to individual needs, making education more engaging, effective, and accessible.\n\nOur platform combines intelligent content generation, interactive learning modules, comprehensive progress tracking, and real-time AI assistance to deliver a complete educational ecosystem. Whether you're a student seeking to master new concepts or an educator looking to enhance your teaching methods, StudyFlow provides the tools and insights needed for academic success.\n\n## 2. 🎯 Problem Statement\n\nTraditional educational approaches face several critical challenges in today's digital age:\n\n- **Generic Content Delivery**: One-size-fits-all educational content that doesn't adapt to individual learning styles and paces\n- **Limited Personalization**: Lack of personalized learning paths that address specific strengths and weaknesses\n- **Ineffective Progress Tracking**: Difficulty in accurately measuring learning progress and identifying knowledge gaps\n- **Resource Accessibility**: Limited access to diverse, high-quality educational materials and real-time assistance\n- **Engagement Issues**: Traditional learning methods often fail to maintain student engagement and motivation\n- **Assessment Challenges**: Static assessments that don't provide immediate feedback or adapt to student performance\n\nStudyFlow addresses these challenges by:\n\n- **AI-Driven Personalization**: Creating adaptive learning experiences tailored to each individual\n- **Intelligent Content Generation**: Producing dynamic, relevant educational content using advanced AI\n- **Real-Time Analytics**: Providing comprehensive insights into learning progress and performance\n- **Accessible AI Assistance**: Offering 24/7 intelligent tutoring and support\n- **Gamified Learning**: Implementing engaging, interactive elements to boost motivation\n- **Adaptive Assessment**: Creating dynamic quizzes and evaluations that adjust to student performance\n\n## 3. 🚀 Live Demo\n\n🌐 **[Experience StudyFlow Live](https://study-flow.taskforges.com)**\n\n### ⚠️ Important Notes\n\n- **Server Startup**: The backend is deployed on Render's free tier, so initial server response may take anywhere from a few seconds to a few minutes. Please be patient during the first request.\n\n### Demo Credentials\n\n- **Email**: sokarama79@gmail.com\n- **Password**: sokarama79@gmail.com\n\n## 4. 🎬 Live Video Demonstration\n\n## Video Demonstrations\n\nWatch our platform in action:\n\n[![Study Flow Demo](https://img.youtube.com/vi/SaCoIQQgDlw/maxresdefault.jpg)](https://youtu.be/SaCoIQQgDlw?si=RofbgUg8D2AZxgqq)\n\n## 5. ✨ Key Features\n\n### 🧠 AI-Powered Learning Engine\n\n- **Intelligent Content Generation**: Dynamically creates lessons, quizzes, and educational materials using OpenAI GPT and Google's Gemini AI\n- **Adaptive Learning Paths**: Personalizes learning journeys based on individual progress and performance analytics\n- **Smart Tutoring System**: Provides contextual assistance and explanations through our AI chatbot with platform-specific guidance\n- **Weakness Detection**: Analyzes performance patterns to identify and focus on challenging topics\n\n### 📚 Comprehensive Subject Management\n\n- **Structured Learning**: Organized subjects with topic-based curriculum structure\n- **Progress Tracking**: Real-time visualization of completion rates and learning milestones\n- **Subject Discovery**: Explore and add subjects to create personalized learning paths\n- **Topic Mastery**: Track detailed progress within each subject's topics\n\n### 🎯 Interactive Assessment System\n\n- **AI-Generated Quizzes**: Creates adaptive quizzes tailored to topic difficulty and student performance\n- **Instant Feedback**: Provides immediate results and explanations for better understanding\n- **Multiple Question Types**: Supports various assessment formats including MCQs, short answers, and essay questions\n- **Performance Analytics**: Detailed insights into quiz performance and improvement areas\n\n### 🎮 Gamified Learning Experience\n\n- **Interactive Games**: Educational games that make learning fun and engaging\n- **Achievement System**: Rewards and badges for reaching learning milestones\n- **Leaderboards**: Competitive elements to motivate continuous learning\n- **Progress Visualization**: Beautiful charts and graphs to track learning journey\n\n### 💻 Modern Technical Infrastructure\n\n- **Real-Time Synchronization**: Live updates across all devices and sessions\n- **Secure Authentication**: JWT-based authentication with refresh token support\n- **File Management**: Upload and organize educational materials and resources\n- **Responsive Design**: Seamless experience across desktop, tablet, and mobile devices\n\n### 🔍 Advanced Analytics \u0026 Insights\n\n- **Learning Analytics**: Comprehensive dashboard with performance metrics\n- **Weakness Analysis**: Identifies knowledge gaps and suggests improvement strategies\n- **Time Tracking**: Monitors study time and learning patterns\n- **Progress Reports**: Detailed reports for students and educators\n\n## 6. 🛠️ Technical Stack\n\n### Frontend Architecture\n\n- **Framework**: Next.js 15.2.2 with React 19 and TypeScript\n- **Styling**: Tailwind CSS with custom design system\n- **UI Components**:\n  - Radix UI primitives for accessibility\n  - shadcn/ui for consistent design components\n  - Custom components for platform-specific features\n- **Icons \u0026 Graphics**: Lucide React, React Icons for comprehensive iconography\n- **Animations**: Framer Motion for smooth, engaging user interactions\n- **State Management**: Zustand for lightweight, efficient state handling\n- **Form Handling**: React Hook Form with Zod validation for type-safe forms\n- **Rich Content**:\n  - Quill editor for rich text editing\n  - React Markdown for content rendering\n  - Syntax highlighting for code examples\n- **Data Visualization**: Recharts for interactive charts and progress tracking\n\n### Backend Infrastructure\n\n- **Runtime**: Node.js with TypeScript for type safety\n- **Framework**: Express.js with middleware architecture\n- **Database**:\n  - Neon PostgreSQL for scalable data storage\n  - Drizzle ORM for type-safe database operations\n  - Connection pooling for optimal performance\n- **AI Integration**:\n  - OpenAI GPT API for content generation\n  - Google Gemini AI for alternative AI processing\n  - SmythOS Agent Builder\n  - LangChain for AI workflow orchestration\n  - Pinecone vector database for semantic search and RAG\n- **Authentication**: JWT with bcrypt for secure user management\n- **File Storage**: AWS S3 compatible storage (Cloudflare R2)\n- **Communication**:\n  - Nodemailer for email notifications\n  - Socket.IO for real-time features\n- **Agent Orchestration**: SmythOS Agent Builder\n\n### Development \u0026 DevOps\n\n- **Package Management**: pnpm for efficient dependency management\n- **Code Quality**: ESLint, Prettier for consistent code style\n- **Build Tools**: Next.js built-in compiler and bundling\n- **Database Management**: Drizzle Kit for migrations and schema management\n- **Environment Management**: Environment-specific configurations\n- **API Documentation**: RESTful API with comprehensive endpoint documentation\n\n## 7. 📦 Installation\n\n### Prerequisites\n\nEnsure you have the following installed:\n\n- **Node.js** 18+ (LTS recommended)\n- **PostgreSQL** database (Neon recommended)\n- **pnpm** package manager (recommended) or npm\n- **Git** for version control\n\n### API Keys Required\n\n- **OpenAI API Key** for content generation\n- **Google Gemini API Key** for AI processing\n- **SmythOS Agent LLM Key** for agent orchestration\n- **Pinecone API Key** for vector database\n- **Cloudflare R2** credentials for file storage\n- **Gmail App Password** for email notifications\n\n### Environment Configuration\n\n#### Client Environment (`.env.local`)\n\n```env\nNEXT_PUBLIC_BACKEND_BASE_URL=http://localhost:8000\n```\n\n#### Server Environment (`.env`)\n\n```env\n# Database Configuration\nDATABASE_URL=postgresql://username:password@host:port/database?sslmode=require\u0026channel_binding=require\n\n# Server Configuration\nPORT=8000\nJWT_SECRET=your_jwt_secret_key\n\n# Email Configuration (Gmail App Password)\nEMAIL_USER=your_email@gmail.com\nEMAIL_PASS=your_app_password\n\n# SmythOS Agent LLM API Key\nSMYTHOS_AGENTLLM_KEY=sk-your_smythos_agent_key\n\n# Cloudflare R2 Bucket Credentials\nTOKEN_VALUE=your_cloudflare_r2_token\nACCESS_KEY_ID=your_access_key_id\nSECRET_ACCESS_KEY=your_secret_access_key\nENDPOINT_URL=https://your_account_id.r2.cloudflarestorage.com\nPUBLIC_ACCESS_URL=https://pub-your_public_id.r2.dev\nBUCKET_NAME=your_bucket_name\n\n# AI API Keys\nGEMINI_API_KEY=\"your_gemini_api_key\"\nOPENAI_API_KEY=sk-proj-your_openai_api_key\n\n# Environment Configuration\nNODE_ENV=development\n\n# SmythOS API Endpoints\nTOPIC_LIST_URL=https://your_topic_list_agent.agent.a.smyth.ai/api/generate_topic_list\nMENTAL_STATUS_URL=https://your_mental_status_agent.agent.a.smyth.ai/api/evaluate_quiz\n\n# Pinecone Vector Database\nPINECONE_API_KEY=pcsk_your_pinecone_api_key\nPINECONE_INDEX=your_index_name\n```\n\n### Quick Start\n\n1. **Clone the Repository**\n\n```bash\ngit clone https://github.com/Ajor-Saha/DeltaCoders-Final-Test\ncd DeltaCoders-Final-Test\n```\n\n2. **Install Dependencies**\n\n```bash\n# Install client dependencies\ncd client\npnpm install\n\n# Install server dependencies\ncd ../server\nnpm install\n```\n\n3. **Database Setup**\n\n```bash\ncd server\n\n# Generate database schema\nnpm run db:generate\n\n# Run migrations\nnpm run db:migrate\n\n# Push schema changes\nnpm run db:push\n```\n\n4. **Start Development Environment**\n\nOpen two terminal windows:\n\n**Terminal 1 - Backend Server:**\n\n```bash\ncd server\nnpm run dev\n```\n\n**Terminal 2 - Frontend Application:**\n\n```bash\ncd client\npnpm dev\n```\n\n5. **Access Your Application**\n\n- **Frontend**: http://localhost:3000\n- **Backend API**: http://localhost:8000\n\n## 8. 📁 Project Structure\n\n```\nstudyflow/\n├── README.md                        # Project documentation\n├── client/                          # Frontend Next.js application\n│   ├── src/\n│   │   ├── app/                     # App Router pages and layouts\n│   │   │   ├── (admin)/            # Admin dashboard routes\n│   │   │   ├── (application)/      # Main application routes\n│   │   │   ├── (auth)/             # Authentication pages\n│   │   │   ├── globals.css         # Global styles\n│   │   │   └── layout.tsx          # Root layout\n│   │   ├── components/             # Reusable React components\n│   │   │   ├── ui/                 # Base UI components (shadcn/ui)\n│   │   │   ├── admin/              # Admin-specific components\n│   │   │   ├── charts/             # Data visualization components\n│   │   │   ├── chatbot/            # AI chatbot components\n│   │   │   ├── games/              # Educational game components\n│   │   │   └── header/             # Navigation components\n│   │   ├── config/                 # Configuration files\n│   │   ├── constants/              # Application constants\n│   │   ├── hooks/                  # Custom React hooks\n│   │   ├── lib/                    # Utility functions\n│   │   ├── schemas/                # Zod validation schemas\n│   │   ├── store/                  # Zustand state management\n│   │   └── types/                  # TypeScript type definitions\n│   ├── public/                     # Static assets\n│   │   └── asset/                  # Images and media files\n│   └── package.json                # Frontend dependencies\n│\n├── server/                         # Backend Express.js application\n│   ├── src/\n│   │   ├── index.ts               # Server entry point\n│   │   ├── config/                # Server configuration\n│   │   ├── controllers/           # Request handlers\n│   │   │   ├── auth-controllers.ts\n│   │   │   ├── dashboard-controllers.ts\n│   │   │   ├── aibot-controllers.ts\n│   │   │   └── ...\n│   │   ├── data/                  # Static data and seeds\n│   │   ├── db/                    # Database configuration\n│   │   │   ├── index.ts          # Database connection\n│   │   │   └── schema.ts         # Drizzle schema definitions\n│   │   ├── middleware/            # Express middleware\n│   │   ├── routes/                # API route definitions\n│   │   ├── types/                 # TypeScript types\n│   │   └── utils/                 # Helper functions\n│   ├── drizzle/                   # Database migrations\n│   └── package.json               # Backend dependencies\n```\n\n### Development Guidelines\n\n- **Code Style**: Follow TypeScript best practices with strict type checking\n- **Commit Convention**: Use conventional commits for clear history\n- **Testing**: Write unit tests for critical functionality\n- **Documentation**: Keep inline documentation updated\n- **Performance**: Optimize for Core Web Vitals and loading speed\n\n## 9. 🤝 Contributing\n\nWe welcome contributions from the community! Here's how you can help:\n\n### Getting Started\n\n1. **Fork the Repository**\n\n   ```bash\n   git fork https://github.com/Ajor-Saha/DeltaCoders-Final-Test\n\n   ```\n\n2. **Create Feature Branch**\n\n   ```bash\n   git checkout -b feature/amazing-new-feature\n   ```\n\n3. **Make Changes**\n   - Follow our coding standards\n   - Add tests for new functionality\n   - Update documentation\n\n4. **Submit Pull Request**\n   ```bash\n   git commit -m \"feat: add amazing new feature\"\n   git push origin feature/amazing-new-feature\n   ```\n\n### Contribution Guidelines\n\n- **Bug Reports**: Use GitHub issues with detailed reproduction steps\n- **Feature Requests**: Discuss new features in GitHub discussions\n- **Code Style**: Follow existing patterns and ESLint rules\n- **Testing**: Ensure all tests pass before submitting\n- **Documentation**: Update relevant documentation for changes\n\n## 10. 📄 License\n\nThis project is licensed under the **ISC License**. See the [LICENSE](LICENSE) file for complete details.\n\n## 11. 🙏 Acknowledgments\n\nWe're grateful to the following technologies and communities:\n\n### Development Tools\n\n- **TypeScript** for type safety and developer experience\n- **ESLint** and **Prettier** for code quality\n- **GitHub** for version control and collaboration\n\n### Special Thanks\n\n- The open-source community for incredible tools and libraries\n- Beta testers and early adopters for valuable feedback\n- Educational institutions for inspiring our mission\n\n---\n\n### **🎓 Built with ❤️ for the future of education**\n\n**StudyFlow** - Empowering learners and educators with AI-driven personalized education.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajor-saha%2Fdeltacoders-final-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajor-saha%2Fdeltacoders-final-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajor-saha%2Fdeltacoders-final-test/lists"}