Too Long; Didn't Read - AI-powered research summarization and knowledge management for space biology research
Team Name: TL;DR Challenge: Build a Space Biology Knowledge Engine
| Name | Role | GitHub |
|---|---|---|
| Ahmed Khaled | Fullstack & Integration Engineer | @a04k |
| Alhussein Ahmed | Research Specialist | |
| Ahmed Elsharkawy | AI & ML Engineer, API Writer | |
| Mahmoud Elsharkawy MSc | Research Expert, (future PhD) | |
| Sandy Adel | Presentation and Content Expert & Biotechnologist |
TL;DR Dashboard is an intelligent research assistant designed to make space biology and scientific research more accessible. Built for the NASA Space Apps Challenge 2025, it transforms complex research papers into digestible summaries and provides interactive AI-powered conversations about scientific topics.
Researchers and professionals often struggle with:
- Information Overload: Thousands of research papers published daily
- Time Constraints: Limited time to read and understand complex studies
- Knowledge Gaps: Difficulty connecting concepts across different papers
- Accessibility: Scientific jargon barriers for non-experts
TL;DR Dashboard provides:
- AI-Powered Summaries: Instant paper summarization with key insights
- Interactive Chat: Context-aware conversations about research topics
- Multi-User Personas: Tailored responses for researchers, students, and business professionals
- Knowledge Mapping: Visual connections between research concepts
- Voice Summaries: Audio playback in multiple languages
- Paper Database: 608+ summarized papers with 2000+ in RAG system
- Smart Conversations: Context-aware chat with research papers
- User Personas: Customized responses for different user types
- Voice Summaries: Text-to-speech in English, Arabic, and French
- Video Generation: AI-generated video summaries (demo)
- Research Database: 608 summarized papers, 2000+ in RAG
- Real-time Stats: Track processing and usage metrics
- Modern UI: Clean, responsive design with dark/light themes
- Interactive Widgets: Time, weather, and system status displays
- Paper Viewer: Enhanced reading experience with AI insights
- Knowledge Mapping: Visual representation of concept relationships
- Search & Discovery: Find relevant papers quickly
- Citation Management: Track and organize research references
- Interface: English (primary)
- Voice Summaries: English, Arabic, French
- Content: Supports international research papers
- Next.js 15 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Radix UI - Accessible component primitives
- Lucide Icons - Beautiful icon library
- Convex - Real-time database and backend
- Google Cloud Run - Scalable API hosting
- TL;DR AI - Custom research summarization
- Google TTS - Text-to-speech synthesis
- Vercel - Alternative deployment option
- GitHub Actions - CI/CD pipeline
- bun (recommended)
- Git
-
Clone the repository
git clone https://github.com/a04k/tldr-spaceapps25.git cd tldr-spaceapps25 -
Install dependencies
bun i
-
Set up environment variables
cp .env.example .env.local
Add your API keys:
GEMINI_API_KEY=your_gemini_api_key CONVEX_DEPLOYMENT=your_convex_deployment CONVEX_URL=your_convex_url AI_API_URL=your_api_endpoint
-
Run the development server
bun run dev
-
Open your browser Navigate to http://localhost:3000
tldr-dashboard/
├── app/ # Next.js App Router pages
│ ├── api/ # API routes
│ ├── laboratory/ # Research lab interface
│ └── layout.tsx # Root layout
├── components/ # React components
│ ├── ai-assistant/ # Chat interface
│ ├── dashboard/ # Dashboard widgets
│ ├── laboratory/ # Research tools
│ └── ui/ # Reusable UI components
├── convex/ # Database schema & functions
├── data/ # Research papers (MDX)
├── lib/ # Utility functions
├── public/ # Static assets
└── types/ # TypeScript definitions
- Full-screen Chat: Immersive conversation interface
- Context Awareness: Understands current paper being viewed
- User Personas: Adapts responses based on user type
- Voice & Video: Multimedia response options
- Overview: Main dashboard with stats and widgets
- Research Activity: Track paper interactions
- System Status: Monitor application health
- Paper Grid: Browse research papers
- Paper Viewer: Enhanced reading experience
- Search: Find relevant research quickly
| Variable | Description | Required |
|---|---|---|
GEMINI_API_KEY |
Google Gemini API key | ✅ |
CONVEX_DEPLOYMENT |
Convex deployment ID | ✅ |
CONVEX_URL |
Convex database URL | ✅ |
AI_API_URL |
TL;DR AI API endpoint | ✅ |
NODE_ENV |
Environment (development/production) | ✅ |
- Format: Scraped PDFs from NASA CSV to MDX files in
data/papers/ - Count: 608 summarized papers
- Topics: Space biology, microgravity, astrobiology
- Sources: NASA, ESA, academic journals
// Conversations
conversations: {
title: string
createdAt: number
updatedAt: number
}
// Messages
messages: {
conversationId: Id<"conversations">
role: "user" | "assistant"
content: string
timestamp: number
}We welcome contributions! Please see our Contributing Guidelines for details.
- NASA Space Apps Challenge - For the inspiring challenge
- Research Community - For the valuable scientific papers
- Open Source Libraries - For the amazing tools and frameworks
- Team Contributors - For their dedication and hard work
This project is licensed under the MIT License - see the LICENSE file for details.
📞 Contact GitHub: @a04k
Built with ❤️ for NASA Space Apps Challenge 2025
Making space research accessible to everyone