Skip to content

Nungo/Lumioly

Repository files navigation

Lumioly

AI-powered news and tools intelligence platform — live articles, curated AI tools, and Gemini-powered "Why This Matters" analysis in one place.

Live Site: [https://web-production-2092.up.railway.app/]
Built for: Dev Season of Code (DSOC) 2026


What is Lumioly?

The AI space moves faster than anyone can keep up with. Lumioly is a fully autonomous intelligence platform that surfaces what matters — live news, curated tools, and instant AI analysis — with zero manual curation.

Every page load pulls fresh articles from five major tech sources. Every tool has an on-demand Gemini explanation. Every article has a "Why This Matters" analysis generated by Gemini 2.5 Flash that explains the real-world significance in three sentences.


Features

Feature Description
🔴 Live News Feed Real-time articles from TechCrunch, VentureBeat, The Verge, Ars Technica, Wired
✨ Why This Matters Gemini reads each article and explains its significance to developers
🤖 AI Chat Ask anything about the AI landscape on the homepage
🛠️ Tools Directory 44 curated AI tools across 6 categories
📺 YouTube Tutorials Auto-fetched tutorials for each tool via YouTube Data API
💡 Per-Tool AI Explanations Gemini explains each tool on demand

Tech Stack

Layer Technology
Backend Python 3.13, Django 5.2
AI Google Gemini 2.5 Flash (google-genai)
News RSS feeds via feedparser
Tutorials YouTube Data API v3
Frontend HTML, CSS, Vanilla JS
Database SQLite (dev) → PostgreSQL (production)
Hosting Railway
Static Files WhiteNoise
Design Figma

Local Setup

1. Clone the repo

git clone https://github.com/Nungo/Lumioly.git
cd Lumioly

2. Create virtual environment

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Set up environment variables

Create a .env file in the project root:

SECRET_KEY=your-django-secret-key
DEBUG=True
GEMINI_API_KEY=your-gemini-api-key
YOUTUBE_API_KEY=your-youtube-api-key
CRON_SECRET=any-random-string

5. Run migrations and seed tools

python manage.py migrate
python manage.py seed_tools

6. Start the server

python manage.py runserver

Visit http://localhost:8000


Project Structure

lumioly/
├── ai_curator_project/     # Django project settings
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── curator_app/            # Main application
│   ├── views.py            # All view logic including Why This Matters
│   ├── models.py           # AiTool, NewsItem models
│   ├── ai_client.py        # Gemini API client
│   ├── urls.py
│   └── management/
│       └── commands/
│           └── seed_tools.py   # Seeds 44 AI tools
├── templates/
│   ├── base.html           # Dark luxury design system
│   ├── home.html           # Homepage with AI chat
│   └── curator_app/
│       ├── news_list.html      # Live news feed
│       ├── article_detail.html # Why This Matters page
│       ├── tool_list.html      # Tools directory
│       └── tool_detail.html    # Tool detail with AI + YouTube
├── requirements.txt
├── Procfile                # Railway deployment
└── runtime.txt             # Python 3.13

Deployment (Railway)

The app is deployed on Railway with the following start command:

python manage.py migrate && python manage.py seed_tools && python manage.py collectstatic --noinput && gunicorn ai_curator_project.wsgi --log-file -

Environment variables required:

  • SECRET_KEY
  • GEMINI_API_KEY
  • YOUTUBE_API_KEY
  • CRON_SECRET
  • DEBUG = False

What I Built During DSOC 2026

  • Lumioly — designed and built the full platform from my own design framework, including live RSS news aggregation from five major tech sources, the AI tools directory, Gemini-powered chat, and the dark luxury aesthetic across desktop and mobile
  • Why This Matters — the centrepiece feature: Gemini reads every article and generates a three-sentence analysis explaining its real-world significance to developers right now
  • Topic restriction & prompt injection protection — AI system prompt that keeps Lumioly strictly focused on AI and tech, with graceful redirects for off-topic queries
  • QA & edge case testing — boundary testing including off-topic queries, borderline questions, and prompt injection attempts
  • UX/UI Design — full Figma documentation with desktop and mobile screens, design system, and clickable prototype
  • Full deployment — live on Railway with PostgreSQL, WhiteNoise, and autonomous RSS pipeline

Built by

Nungo Tshidzumba — Creative Technologist, Pretoria, South Africa
Portfolio · LinkedIn


Powered by Gemini 2.5 Flash · Deployed on Railway · Built for DSOC 2026

About

Lumioly is an intelligent AI news and tools platform that automatically surfaces what matters in the world of artificial intelligence, without you having to hunt for it.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages