ai-signal 0.1.6

Terminal-based AI curator that turns information noise into meaningful signal

AI Signal

Terminal-based AI curator that turns information noise into meaningful signal.

Features

• 🤖 AI-powered content analysis and categorization
• 🔍 Smart filtering based on customizable categories and quality thresholds
• 📊 Advanced sorting by date, ranking, or combined criteria
• 🔄 Automatic content synchronization from multiple sources
• 🌐 Support for various content sources (YouTube, Medium, Reddit, Hacker News, RSS feeds)
• 📱 Share curated content directly to social media
• 📝 Export to Obsidian vault with customizable templates
• ⌨️ Fully keyboard-driven interface
• 🎨 Beautiful terminal UI powered by Textual

Installation

pip install ai-signal

Or with poetry:

poetry add ai-signal

Quick Start

1. Create a configuration file:

aisignal init

2. Edit your ~/.config/aisignal/config.yaml along these lines:

sources:
- https://news.ycombinator.com
- https://django-news.com

prompts:
  content_extraction: |
    Please extract the top 10 news, articles, posts, whatever items compose this list.

    For each items, find or generate:
    * the title
    * the source (URL of the list source)
    * the original URL of the item, or _link_
    * the categories, among the available ones, listed below.

    Generate a list of items in markdown format, strictly following this syntax:

    # Top 10 Items

    1. **Title:** Announcing the 6.x Django Steering Council elections 🚀  
       **Source:** https://django-news.com  
       **Link:** https://cur.at/3TNDN81?m=web  
       **Categories:** Django

    2. **Title:** Django Channels 4.2.0 Release Notes  
       **Source:** https://django-news.com
       **Link:** https://cur.at/R9ZJhRV?m=web  
       **Categories:** Django
    ...
 
    In particular, the Source should only contain the URL.

categories:
- AI/ML
- Django
- Programming
- Security
- DevOps
- Docker
- Modern Data Stack

quality_threshold: 0.7
sync_interval: 24
obsidian:
  vault_path: '/~/Documents/Obsidian Vault'
  template_path: ''
social:
  twitter_template: '{title}


    {url}


    #AI #Content'
api_keys:
  jinaai: -Your JinaAI key-
  openai: -Your OpenAI key

3. Run AI Signal:

aisignal

Keyboard Shortcuts

For all views

• q: Quit application
• c: Toggle configuration panel
• s: Force sync content
• f: Toggle filters

Within the items list

• ↑/↓: Navigate items
• enter: Show item details
• o: Open in browser
• t: Share on Twitter
• l: Share on LinkedIn
• e: Export to Obsidian

Configuration

AI Signal can be configured via YAML file or through the TUI configuration panel. Main configuration options:

• Content

  • Sources to monitor
  • Sync interval, in hours
  • Categories of interest
  • Prompt for content extraction

• Filtering

  • Quality threshold
  • Category filters
  • Source filters

• Integration

  • Obsidian vault path
  • Obsidian templates
  • Social media templates

See the configuration guide for detailed options.

Screenshots

Main Interface

Content Details

Configuration Panel

Contributing

Contributions are welcome! Please read our Contributing Guide to get started.

Development Setup

# Clone the repository
git clone https://github.com/guglielmo/ai-signal.git
cd ai-signal

# Install dependencies
poetry install

# Run tests
poetry run pytest

# Run the application in development mode
poetry run aisignal version

or, entering the virtualenv:

poetry shell
aisignal version

Roadmap

• Add support for more content sources (YT videos, podcasts, pdf)
• Implement custom AI models
• Add content archiving
• Enable custom prompts for sources
• Enable custom filtering rules
• Add data export/import

License

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

Acknowledgments

• Built with Textual
• AI powered by OpenAI and Jina AI
• Inspired by Daniel Miessler's Fabric

Author

Guglielmo Celata

• GitHub: @guglielmo
• Mastodon: @[e-mail]