Skip to content

thefirehacker/TimeCapsule-SLM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TimeCapsule-SLM Logo

πŸš€ TimeCapsuleSLM

Solving Open Learning with a Complete AI-Powered Platform for Research, Creativity, and Collaboration

The Ultimate AI-Powered Research & Learning Platform

Next.js TypeScript Ollama License

πŸ† Participating in Google Gemma 3n Impact Challenge

Transform how you research, learn, and collaborate with AI-powered tools that adapt to your workflow.

πŸš€ Live Demo β€’ πŸ› Report Bug β€’ πŸ’‘ Request Feature


🎯 The Problem We're Solving

In today's digital age, researchers, educators, and learners face several critical challenges:

πŸ” Research Fragmentation

  • Research findings scattered across multiple tools and platforms
  • No unified way to capture, organize, and share research insights
  • Difficulty in maintaining context across different research sessions

πŸ“š Learning Inefficiency

  • Traditional learning methods lack personalization and interactivity
  • No seamless integration between video content, documents, and AI assistance
  • Learning experiences are often linear and don't adapt to individual needs

πŸ€– AI Integration Gaps

  • AI tools are isolated and don't work together cohesively
  • Limited local AI capabilities for privacy-conscious users
  • No unified platform for combining multiple AI models and services

πŸ” Privacy & Control

  • Dependence on cloud-based services that may compromise data privacy
  • Limited control over personal research data and learning materials
  • No offline-first approach for sensitive research work

πŸŽ“ Educational Challenges

  • Low-Resource Environments: Teachers lack tools to create engaging content without expensive infrastructure
  • Teacher Workload: Manual lesson planning and content organization is time-consuming
  • Student Engagement: Traditional linear learning doesn't adapt to individual student needs
  • Offline Learning: Limited access to internet connectivity in many educational settings
  • Collaboration Barriers: Students and teachers struggle to collaborate effectively in remote or offline scenarios

✨ Our Solution: TimeCapsuleSLM

TimeCapsuleSLM is a comprehensive AI-powered platform that addresses these challenges by providing:

🧠 DeepResearch TimeCapsule

Transform your research workflow with AI-powered insights and collaborative discovery.

  • πŸ”¬ Advanced Research Platform: Generate novel insights and discover hidden patterns
  • 🀝 Collaborative Discovery: Work together with AI agents and human collaborators
  • πŸ“¦ TimeCapsule Export/Import: Save and share complete research sessions
  • πŸ”— Knowledge Base Integration: Seamlessly connect with your local knowledge base

πŸŽ₯ AI-Frames Interactive Learning

Create structured, adaptive learning experiences that evolve with your needs.

  • πŸ“Ή Video Integration: Timestamp-controlled video segments for focused learning
  • πŸ“„ Document Support: Rich text, PDF, and multimedia content integration
  • πŸ€– AI-Powered Assistance: Contextual help and concept explanations
  • 🎯 Goal-Oriented Navigation: Sequential learning paths with clear objectives

πŸ“š Knowledge Base Management

Your personal AI-powered library that grows with you.

  • πŸ” In-Browser RAG: Retrieval-Augmented Generation for intelligent search
  • πŸ“ Document Processing: Upload and process your own documents
  • πŸ” Privacy-First: Your data stays local and secure
  • 🧠 Semantic Search: Find information using natural language queries

πŸ€– Multi-Agent AI System

A unified AI ecosystem that adapts to your workflow.

  • πŸ”„ Multiple AI Providers: Support for Ollama, LM Studio, OpenAI, and more
  • 🏠 Local LLM Support: Run AI models locally for complete privacy
  • 🎯 Contextual Assistance: AI that understands your current context
  • 🧩 Modular Architecture: Mix and match AI capabilities as needed

πŸŽ“ Education Solutions

TimeCapsuleSLM revolutionizes education by providing powerful tools for both teachers and students, especially in low-resource environments:

πŸ‘¨β€πŸ« For Teachers

πŸ“š Knowledge Base Setup

  • Organize Content: Upload and organize notes, books, and educational materials
  • Smart Categorization: AI automatically categorizes and tags content for easy retrieval
  • Offline Access: All content available locally without internet dependency

πŸ“ Content Annotation & Organization

  • Rich Annotations: Add pointers, remarks, and contextual notes to any content
  • TimeCapsule Export: Save annotated content as shareable TimeCapsules
  • Collaborative Notes: Share annotations with other teachers and students

πŸ“‹ Dynamic Lesson Planning

  • AI-Powered Planning: Create lesson plans that AI can modify based on real-time requirements
  • Adaptive Content: AI adjusts lesson complexity based on student performance
  • TimeCapsule Integration: Export complete lesson plans as TimeCapsules for reuse

πŸ‘¨β€πŸŽ“ For Students

🧠 Smart AI-Generated Insights

  • Novel Discoveries: Get unique insights from existing content through AI analysis
  • Concept Connections: AI reveals hidden relationships between different topics
  • Personalized Learning: AI adapts explanations to individual learning styles

🎯 Self-Guided Learning

  • Teacher-Independent Learning: Access premade TimeCapsules when teachers are unavailable
  • Structured Guidance: AI provides step-by-step guidance through complex topics
  • Progress Tracking: Monitor learning progress with AI-powered analytics

🎬 Non-Linear Learning with AI-Frames

  • De-linearized Content: AI-Frames break down linear content into interactive, adaptive experiences
  • Personalized Paths: Students can choose their own learning journey
  • Interactive Elements: Videos, documents, and AI assistance work together seamlessly

🀝 Offline Collaboration

  • Community Learning: Students can collaborate and share knowledge offline
  • Skill Development: Community-based skill updation through shared TimeCapsules
  • Peer-to-Peer Learning: Students can create and share their own learning materials

🌍 Low-Resource Environment Benefits

  • πŸ–₯️ Minimal Hardware: Works on basic computers and tablets
  • πŸ“‘ Offline-First: No constant internet connection required
  • πŸ’° Cost-Effective: Free and open-source, no expensive licenses
  • πŸ”‹ Low Power: Optimized for devices with limited resources
  • πŸ“š Local Storage: All content stored locally for instant access

πŸš€ Key Features

Feature Description Benefits
🧠 DeepResearch AI-powered research with multi-agent collaboration Discover insights faster with AI assistance
πŸŽ₯ AI-Frames Interactive learning with video and document integration Create engaging, personalized learning experiences
πŸ“š Knowledge Base Local RAG system with semantic search Keep your data private while leveraging AI
πŸ€– Multi-Agent AI Unified AI ecosystem with local and cloud options Choose the right AI for each task
πŸ”„ TimeCapsule Export Complete session export/import system Share and preserve your work
🎨 Modern UI Beautiful, responsive interface built with Next.js Enjoy a seamless user experience
πŸ” Privacy-First Local processing and optional cloud integration Maintain control over your data
πŸ‘¨β€πŸ« Teacher Tools Dynamic lesson planning and content annotation Reduce workload and create better learning experiences
πŸ‘¨β€πŸŽ“ Student Features Self-guided learning and offline collaboration Learn independently and collaborate without internet
🌍 Low-Resource Ready Optimized for minimal hardware and offline use Accessible education in any environment

πŸ€– AI Models & Agentic Capabilities

Supported Models

  • 🟒 Gemma 3n: Google's latest open model for research and learning
  • 🟑 Quen: Advanced reasoning and problem-solving capabilities
  • πŸ”΅ Ollama Models: Local deployment of various open-source models

Agentic Features

  • πŸ€– Multi-Agent Collaboration: Multiple AI agents working together on complex tasks
  • 🧠 Contextual Memory: AI agents maintain context across sessions
  • 🎯 Task Specialization: Different agents for research, learning, and analysis
  • πŸ”„ Adaptive Behavior: Agents learn and adapt to user preferences
  • πŸ“Š Intelligent Orchestration: Smart coordination between different AI capabilities

πŸ› οΈ Technology Stack

Next.js React TypeScript Ollama RxDB

Core Technologies

  • Frontend: Next.js 15, React 19, TypeScript
  • Database: RxDB (local)
  • AI Integration: Ollama, OpenAI, LM Studio
  • Document Processing: PDF.js, Transformers.js
  • UI Components: Radix UI, Framer Motion, Lucide React
  • Authentication: NextAuth.js

πŸš€ Quick Start

Prerequisites

  • Ollama for local AI models
  • Node.js 18+
  • npm, yarn, pnpm, or bun

Installation

# Clone the repository
git clone https://github.com/thefirehacker/TimeCapsule-SLM.git
cd TimeCapsule-SLM

# Install dependencies
npm install
# or
yarn install
# or
pnpm install
# or
bun install

# Set up environment variables
cp env.example .env.local
# Edit .env.local with your configuration

# Run the development server
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

Environment Variables

Create a .env.local file with the following variables:

# Authentication
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-secret-key

# AI Providers (Optional)
OPENAI_API_KEY=your-openai-api-key
OLLAMA_HOST=http://localhost:11434

# Email (Optional - for notifications)
RESEND_API_KEY=your-resend-api-key

πŸ“– Usage Guide

🧠 DeepResearch TimeCapsule

  1. Start Research: Navigate to the DeepResearch section
  2. Define Topic: Enter your research question or topic
  3. AI Collaboration: Work with AI agents to explore and analyze
  4. Save Progress: Export your research as a TimeCapsule
  5. Share & Collaborate: Import TimeCapsules to continue or share work

πŸŽ₯ AI-Frames Learning

  1. Create Frame: Start with a learning goal
  2. Add Content: Include videos, documents, and context
  3. AI Assistance: Get contextual help and explanations
  4. Build Path: Create connected learning sequences
  5. Export Experience: Share learning paths via TimeCapsules

πŸ“š Knowledge Base

  1. Upload Documents: Add PDFs, text files, and other documents
  2. Process Content: Let AI extract and index your content
  3. Search & Query: Use natural language to find information
  4. Integrate: Connect with research and learning workflows

πŸ”§ Troubleshooting

Ollama Connection Issues

If you're having trouble connecting to Ollama from different domains, use these settings:

For macOS/Linux:

# Set Ollama to accept connections from any domain
OLLAMA_HOST=0.0.0.0 OLLAMA_ORIGINS="*" ollama serve

For Windows (Command Prompt):

# Set Ollama to accept connections from any domain
set OLLAMA_HOST=0.0.0.0
set OLLAMA_ORIGINS=*
ollama serve

For Windows (PowerShell):

# Set Ollama to accept connections from any domain
$env:OLLAMA_HOST="0.0.0.0"
$env:OLLAMA_ORIGINS="*"
ollama serve

Common Issues

Issue Solution
Build Errors Clear .next folder and reinstall dependencies
AI Connection Check API keys and network connectivity
Database Issues Clear browser storage for local data
Performance Ensure sufficient RAM for local AI models

Getting Help


🀝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

  • πŸ› Report Bugs: Help us identify and fix issues
  • πŸ’‘ Request Features: Suggest new capabilities
  • πŸ“ Improve Documentation: Make our docs better
  • πŸ”§ Submit Code: Contribute code improvements
  • 🌟 Star the Project: Show your support

Development Setup

# Fork and clone the repository
git clone https://github.com/your-username/TimeCapsule-SLM.git
cd TimeCapsule-SLM

# Create a feature branch
git checkout -b feature/amazing-feature

# Make your changes
# ... your code changes ...

# Commit your changes
git commit -m 'Add amazing feature'

# Push to your fork
git push origin feature/amazing-feature

# Create a Pull Request

Code Style

  • Follow TypeScript best practices
  • Use Prettier for code formatting
  • Write meaningful commit messages
  • Add tests for new features

πŸ“„ License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Community driven β€’ Optional paid add-ons β€’ Open source core


πŸ“Š Project Statistics


πŸ“ˆ Star History


Made with ❀️ by thefirehacker

If this project helps you, please give it a ⭐️ on GitHub!