Turn lengthy articles into bite-sized insights with AI-powered summarization
Welcome to PulsePoint-v2, whether you're a busy professional, student, or just someone who loves staying informed without the information overload, this tool has got your back!
git clone https://github.com/yassnemo/PulsePoint.v2
cd PulsePoint-v2
npm installCreate your .env file:
cp .env.example .env
Then edit .env and add your Gemini API key:
# Get this from https://aistudio.google.com/app/apikey
GEMINI_API_KEY=your_actual_api_key_here
# Optional customizations
GEMINI_MODEL=gemini-1.5-flash
MAX_CONTENT_LENGTH=30000
NODE_ENV=development
# Development mode (with hot reloading)
npm run dev
# Production build
npm run build
npm start
Visit http://127.0.0.1:5000 and start summarizing! 🎉
This app is built for Vercel and deploys effortlessly:
-
Connect your repo to Vercel
-
Add environment variables in the Vercel dashboard:
GEMINI_API_KEY: Your Google AI API keyGEMINI_MODEL:gemini-1.5-flash(or your preferred model)MAX_CONTENT_LENGTH:30000(optional)
-
Deploy: Vercel handles the rest automagically! ✨
- Paste an article URL into the input field
Need articles to try? Here are some great sources for testing:
- BBC News
- The Verge
- National Geographic
- Reuters
- Ars Technica
- Smithsonian Magazine
- NPR
- Medium
- Scientific American
- The Guardian
Just copy any article link from these sites and paste it above!
-
Hit that "Summarize" button (or press Enter like a pro)
-
Watch the magic happen - you'll get:
- 📝 A concise summary (2-3 sentences)
- 🎯 Key bullet points with the most important details
- 📊 Compression stats (how much content we saved you!)
- 🖼️ Article image (when available)
| Variable | Description | Default | Required |
|---|---|---|---|
GEMINI_API_KEY |
Your Google AI API key | - | ✅ Yes |
GEMINI_MODEL |
AI model to use | gemini-1.5-flash |
❌ No |
MAX_CONTENT_LENGTH |
Max characters to process | 30000 |
❌ No |
NODE_ENV |
Environment mode | development |
❌ No |
Want to tweak the AI behavior? Check out the prompt in api/summarize.ts - it's designed to be easily customizable for different use cases.
I'd love your help making this even better! Here's how:
git clone https://github.com/yassnemo/PulsePoint.v2
cd PulsePoint-v2
git checkout -b my-feature
# Make your changes
git add .
git commit -m "Describe your change"
git push origin my-feature
# Then open a pull request on GitHub (I'll review it as soon as possible)
- 🐛 Bug fixes (especially edge cases in web scraping)
- ✨ New features (language support, export options, etc.)
- 🎨 UI improvements (animations, accessibility, mobile experience)
- 📚 Documentation (code comments, examples, tutorials)
- 🚀 Performance optimizations (bundle size, loading speed)
❌ "Invalid URL format"
- Make sure your URL includes
http://orhttps:// - Check for typos or special characters
❌ "Failed to scrape article"
- Some sites block automated access (looking at you, paywalls!)
- Try a different article or check if the URL is accessible
❌ "AI summarization failed"
- Check your Gemini API key and quota
- The app will fall back to basic summarization automatically
❌ Build errors
- Clear
node_modulesand reinstall:rm -rf node_modules package-lock.json && npm install - Make sure you're using Node.js 18+
- 🐛 Found a bug? Open an issue with steps to reproduce
- 💡 Have an idea? Start a discussion - we love feedback!
- 🤔 Need help? Check existing issues or create a new one
- Bundle size: ~26KB CSS, ~277KB JS (optimized and tree-shaken)
- First load: Sub-second on modern connections
- Summarization: Typically 2-5 seconds depending on article length
- Memory usage: Minimal footprint with smart caching
MIT License – feel free to use this for whatever you'd like!
Just remember to give credit where it's due.
Created by Yassine Erradouani