Skip to content

sanchez314c/ai-feed

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

AIFEED πŸ€–

AI Intelligence Dashboard - Comprehensive AI content aggregation platform

Version

License: MIT Electron TypeScript React Platform

πŸ“Έ Main Interface

AIFEED Dashboard

The Ultimate AI Intelligence Dashboard - Comprehensive AI content aggregation platform

AIFEED is a powerful desktop application that brings together the latest AI research, news, and insights from across the web in one intelligent dashboard. Built with Electron, React, and TypeScript, it provides a beautiful interface for monitoring AI trends, research papers, and industry news.

✨ Features

  • πŸ€– Multi-Source Aggregation - Collect AI content from arXiv, News API, YouTube, RSS feeds
  • 🧠 AI-Powered Analysis - Claude API processes content for categorization and summarization
  • πŸ” Smart Filtering - Filter by date, source, category, importance score
  • πŸ’Ύ Local Database - SQLite storage with full-text search capabilities
  • πŸ”„ Background Updates - Automated scheduler for content refresh
  • πŸ”– Bookmarking System - Save important articles for later reference
  • πŸ“– Read Tracking - Mark items as read/unread with progress tracking
  • 🎨 Modern UI - Beautiful dark theme interface with responsive design
  • ⚑ Native Performance - Built with Electron for optimal cross-platform performance
  • πŸ–₯️ Cross-Platform - Works on macOS, Windows, and Linux

πŸ“Έ Screenshots

View Screenshots

Dashboard Overview Main dashboard showing aggregated AI content

Content Analysis AI-powered content analysis and categorization

Filtering Interface Advanced filtering and search capabilities

πŸš€ Quick Start - One-Command Build & Run

Option 1: One-Command Solution (Recommended)

# Clone and build
git clone https://github.com/sanchez314c/ai-feed.git
cd ai-feed

# Build and run with a single command!
./scripts/build-release-run.sh

Option 2: Development Mode

# Run in development mode with hot reload
npm run dev

Build Options

# Build only (don't launch)
npm run dist:current

# Build for all platforms
npm run dist:maximum

# Development with hot reload
npm run electron:dev

# Clean build artifacts
npm run clean

πŸ“‹ Prerequisites

For running from source:

  • Node.js 18+ and npm
  • Python 3.8+ (for AI model integration)
  • Git (for version control)

The application will guide you through installing any missing dependencies.

πŸ› οΈ Installation

Detailed Installation

# Clone the repository
git clone https://github.com/sanchez314c/ai-feed.git
cd ai-feed

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Add your API keys to .env file

# Start the application
npm run dev

Building from Source

# One-command build for current platform
npm run dist:current

# Build for all platforms
npm run dist:maximum

# Development build
npm run electron:dev

Build Output Locations

After building, find your executables in:

  • macOS: dist/AIFEED-*.dmg and dist/mac*/AIFEED.app
  • Windows: dist/AIFEED Setup *.exe
  • Linux: dist/AIFEED-*.AppImage and dist/*.deb

πŸ“– Usage

1. Starting the Application

  • Pre-built Binary: Just double-click the application
  • From Source: Run npm run dev for development or use built executables

2. Setting Up API Keys

Configure your API keys in the .env file:

ANTHROPIC_API_KEY=your_claude_api_key
NEWS_API_KEY=your_news_api_key
YOUTUBE_API_KEY=your_youtube_api_key

3. Managing Content Sources

The app integrates with multiple sources:

  • arXiv: AI research papers (cs.AI, cs.CL, cs.CV, cs.LG, cs.NE)
  • News API: AI-related news articles from various sources
  • YouTube: Content from AI channels and educational content
  • RSS Feeds: OpenAI, Anthropic, Google AI, Meta AI blogs

4. Content Management

  • Browse Content: View aggregated content in the main dashboard
  • Read & Bookmark: Mark articles as read and save important ones
  • Search & Filter: Use advanced filtering to find relevant content
  • Background Updates: Automatic content refresh at configured intervals

πŸ”§ Configuration

Directory Structure

~/.ai-feed/
β”œβ”€β”€ database/          # SQLite database
β”œβ”€β”€ cache/            # Content cache
β”œβ”€β”€ config.json       # App configuration
└── logs/             # Application logs

Environment Variables

# Set custom content cache directory
export AIFEED_CACHE_DIR=/path/to/cache

# Set custom database directory
export AIFEED_DB_DIR=/path/to/database

# Set custom update interval (minutes)
export AIFEED_UPDATE_INTERVAL=30

# Disable background updates
export AIFEED_NO_BACKGROUND=1

πŸ› Troubleshooting

Common Issues

API Keys not working

Ensure your API keys are correctly set in the .env file:

  1. Check that the file exists and is named .env
  2. Verify API keys are valid and have sufficient quota
  3. Restart the application after updating keys
Content not updating
  1. Check internet connection
  2. Verify API keys are working
  3. Check update interval settings
  4. Review logs in ~/.ai-feed/logs/
Database issues
  1. Close the application and restart
  2. Check disk space availability
  3. Verify database directory permissions
  4. Reset database by deleting ~/.ai-feed/database/ folder
Performance issues
  • Reduce update frequency in settings
  • Clear cache periodically
  • Limit content sources if needed
  • Check system resources (RAM/CPU usage)

πŸ“ Project Structure

ai-feed/
β”œβ”€β”€ package.json              # Node.js configuration and dependencies
β”œβ”€β”€ package-lock.json         # Dependency lock file
β”œβ”€β”€ tsconfig.json             # TypeScript configuration
β”œβ”€β”€ .eslintrc.json            # ESLint configuration
β”œβ”€β”€ src/                      # Source code
β”‚   β”œβ”€β”€ main/                # Electron main process
β”‚   β”‚   β”œβ”€β”€ main.ts          # Main application entry point
β”‚   β”‚   └── preload.ts       # Preload script
β”‚   β”œβ”€β”€ renderer/            # React frontend
β”‚   β”‚   β”œβ”€β”€ App.tsx          # Main React component
β”‚   β”‚   β”œβ”€β”€ components/      # UI components
β”‚   β”‚   β”œβ”€β”€ services/        # API services
β”‚   β”‚   β”œβ”€β”€ types/           # TypeScript definitions
β”‚   β”‚   └── styles/          # CSS stylesheets
β”‚   └── shared/              # Shared utilities and types
β”œβ”€β”€ build_resources/          # Build resources and assets
β”‚   β”œβ”€β”€ icons/               # Platform-specific icons
β”‚   └── screenshots/         # Application screenshots
β”œβ”€β”€ scripts/                 # Build and utility scripts
β”‚   β”œβ”€β”€ build-release-run.sh # Unified build script
β”‚   └── build-compile-dist.sh # Comprehensive build script
β”œβ”€β”€ docs/                    # Documentation
β”œβ”€β”€ archive/                 # Archived/backup files
└── dist/                    # Build outputs (generated)

🀝 Contributing

Contributions are welcome! Please feel free to submit pull requests or create issues for bug reports and feature requests.

Development Setup

# Clone the repo
git clone https://github.com/sanchez314c/ai-feed.git
cd ai-feed

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Add your API keys to .env

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

# Type checking
npm run type-check

πŸ“„ License

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

πŸ™ Acknowledgments

  • arXiv - For providing access to cutting-edge AI research papers
  • News API - For aggregating AI-related news from various sources
  • YouTube API - For access to AI educational content
  • Anthropic Claude - For AI-powered content analysis and summarization
  • Electron - For making cross-platform development possible
  • The open-source AI community for making all of this possible

πŸ”— Links


AIFEED v1.0 - AI Intelligence Dashboard Built with AI!

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •