Intelligent Content Discovery & Curation, Powered by AI
InfluencerPy is an AI-powered content discovery tool that helps you find, monitor, and curate the best content from across the web. Using intelligent AI Scouts, it continuously discovers relevant content, summarizes key insights, and optionally generates social media posts.
Never miss important content in your field again.
Create AI scouts that continuously monitor sources and find relevant content:
- RSS Scouts: Monitor blogs, newsletters, and news feeds
- Reddit Scouts: Track trending discussions and viral posts
- Substack Scouts: Follow newsletter publications
- Search Scouts: Discover trending topics via Google
- Arxiv Scouts: Stay updated on research papers
- HTTP Tool: Extract content from any webpage
- Browser Scouts
⚠️ [Experimental]: Navigate dynamic web pages
🔍 Scouting Mode (Primary): Find and list interesting content
- Curated lists with summaries
- Links to original sources
- Delivered via Telegram
- Perfect for research, competitive intelligence, and staying informed
✍️ Generation Mode (Optional): Create social media posts
- Automatically generate posts from discovered content
- Post directly to X (Twitter)
- Review and edit before publishing
- Maintain your authentic voice
- Beautiful CLI: Rich, interactive terminal interface with dashboards and wizards
- AI-Powered: Uses Gemini or Anthropic for smart content selection and generation
- Self-Improving: Calibration feature learns from your feedback
- Smart Scheduling: Set it and forget it - scouts run automatically
- Telegram Integration: Review discoveries and approve posts from your phone
Ensure you have Python 3.11 or higher.
uv is an extremely fast Python package installer and resolver.
# Install directly from GitHub
uv tool install git+https://github.com/cristianleoo/influencerpy.git
# Run it
influencerpyIf you just want to use the tool anywhere on your system without worrying about dependencies, use pipx:
# Install directly from GitHub
pipx install git+https://github.com/cristianleoo/influencerpy.git
# Run it from anywhere
influencerpyStandard installation in a virtual environment:
git clone https://github.com/cristianleoo/influencerpy.git
cd influencerpy
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install
pip install .If you want to modify the code:
git clone https://github.com/cristianleoo/influencerpy.git
cd influencerpy
pip install -e .Scouts deliver discoveries via Telegram:
- Message
@BotFatheron Telegram to create a new bot and get the Bot Token. - Message
@userinfobotto get your Chat ID. - Run
influencerpy configureand enter these credentials. - Run
influencerpy botto start receiving scout reports.
To monitor paywalled Substack newsletters:
- See the detailed Substack Platform Guide
- Run
influencerpy configureand select "Substack" - Enter your cookies and subdomain when prompted
Start the interactive dashboard:
influencerpyOn your first launch, the Setup Wizard will guide you through:
- Credentials: Securely save your API Keys (Gemini/Anthropic for AI, X/Twitter if posting)
- AI Configuration: Select your preferred model and temperature
- Create a Scout: Choose sources to monitor (e.g., RSS feeds, Reddit, Arxiv)
- Select "Scouting" Intent: Get curated lists with links
- Set Schedule: Daily, weekly, or custom timing
- Run: Scouts find content and send reports to Telegram
- Review: Get organized lists of relevant content with summaries
- Create a Scout: Same as above
- Select "Generation" Intent: Create social posts
- Choose Platform: X (Twitter) or manual copy/paste
- Review in Telegram: Edit and approve before posting
Full documentation is available at https://cristianleoo.github.io/InfluencerPy/.
We welcome contributions!
-
Clone the repo.
-
Install dependencies with hatch or pip.
-
Run tests:
pytest
This project is licensed under the MIT License.