AI-Journo 🤖📰
AI-Journo is an intelligent, autonomous journalism system that discovers, verifies, summarizes, and posts breaking news on X.com (formerly Twitter). Built with a multi-agent architecture using Selenium automation and powered by Google's Gemini 2.0 Flash model, it specializes in covering geopolitics, conflicts, wars, and other high-impact global events.
✨ Features
🔍 Autonomous News Discovery
- Monitors trusted news sources (BBC, Reuters, CNN, Al Jazeera, Dawn)
- Scrapes homepages and search results for breaking news
- Tracks trending topics from verified X.com accounts
🛡️ Intelligent Verification
- Multi-source cross-referencing for fact-checking
- AI-powered content summarization with Gemini 2.0 Flash
- Filters out speculation and unverified information
📝 Professional Content Creation
- Generates concise, neutral summaries optimized for social media
- Maintains journalistic standards and objectivity
- Supports image attachments and media handling
🚀 Automated X.com Management
- Selenium-based browser automation for posting
- Cookie-based session management for persistent login
- Account engagement features (following, searching, monitoring)
🧠 Memory Management
- Tracks processed stories to avoid duplication
- Maintains context across sessions
- Persistent memory for agent coordination
🏗️ Architecture
AI-Journo uses a sophisticated multi-agent system with specialized roles:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ MainAgent │ │ ResearchAgent │ │ WriterAgent │
│ │ │ │ │ │
│ • Orchestrates │◄──►│ • News discovery│◄──►│ • Content │
│ • Memory mgmt │ │ • Verification │ │ creation │
│ • Coordination │ │ • Source checks │ │ • Summarization │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ XAgent │ │ Tools Suite │
│ │ │ │
│ • X.com posting │ │ • Web scraping │
│ • Account mgmt │ │ • Image handling│
│ • Monitoring │ │ • API calls │
└─────────────────┘ └─────────────────┘
🤖 Agent Roles
- MainAgent: Central coordinator managing workflow, memory, and agent communication
- ResearchAgent: Discovers and verifies news from trusted sources
- WriterAgent: Creates optimized social media content from research summaries
- XAgent: Handles all X.com interactions via Selenium automation
🚀 Quick Start
Installation
# Install from PyPI (when published)
pip install xnewsbot
# Or install from source
git clone https://github.com/iPythonezta/AI-Journo.git
cd AI-Journo
pip install -e .
Basic Usage
from xnewsbot import AIJourno
# Initialize with your credentials
journo = AIJourno(
x_username="your_username",
x_password="your_password",
api_key="your_gemini_api_key"
)
# Run a specific task
journo.run("Find and post latest news about Middle East conflicts")
# Monitor breaking news
journo.run("Monitor trending topics and post updates on significant developments")
Environment Setup
- Get Gemini API Key: Visit Google AI Studio to get your API key
- Install Chrome: Required for Selenium automation
- Create directories: The system will create
images/andcookies/folders automatically
📋 Requirements
- Python 3.8+
- Google Chrome (for Selenium automation)
- Gemini API Key (for AI processing)
Dependencies
smolagents>=0.3.0
litellm>=1.0.0
selenium>=4.0.0
requests>=2.25.0
beautifulsoup4>=4.9.0
undetected_chromedriver>=3.4.0
pillow>=8.0.0
urllib3>=1.26.0
🔧 Configuration
Supported News Sources
- BBC News (
https://www.bbc.com/) - Dawn (
https://www.dawn.com/) - Al Jazeera (
https://www.aljazeera.com/) - Reuters, CNN (via web scraping)
X.com Account Monitoring
The system can monitor trusted accounts for breaking news:
@warmonitors@sentdefender@jacksonhinkle- Custom account lists
🛠️ Advanced Usage
Custom Research Tasks
# Research specific topics
journo.run("Research and verify reports about recent developments in Ukraine")
# Monitor specific regions
journo.run("Find breaking news from Middle East sources and create summary post")
Image Handling
# The system automatically handles images
# Images are stored in xnewsbot/images/ directory
# Supports JPEG, PNG formats
# Automatic image attachment to posts
Memory Management
# Memory is automatically managed
# Prevents duplicate story processing
# Maintains context across sessions
# Can be cleared manually if needed
📁 Project Structure
AI-Journo/
├── xnewsbot/
│ ├── __init__.py # Package initialization
│ ├── ai_journo.py # Main AIJourno class
│ ├── agents.py # Multi-agent system setup
│ ├── tools.py # Specialized tools and utilities
│ ├── twitterbot.py # Selenium X.com automation
│ ├── prompts/ # AI agent prompts
│ │ ├── main_prompt.txt
│ │ ├── research_agent_prompt.txt
│ │ ├── writer_prompt.txt
│ │ └── x_agent_prompt.txt
│ └── images/ # Media storage
├── requirements.txt # Dependencies
├── setup.py # Package configuration
└── README.md # This file
🔒 Security & Privacy
- Local Processing: All automation runs locally on your machine
- Credential Management: Secure session handling with cookie storage
- Rate Limiting: Built-in delays to respect platform limits
- No Data Collection: No user data is transmitted to external services (except API calls)
⚠️ Important Notes
Rate Limiting
The system includes built-in rate limiting to respect:
- X.com API limits and platform policies
- News source scraping guidelines
- Gemini API quotas (5 requests per minute)
Responsible Use
- Verify Information: Always cross-check important news before posting
- Respect Sources: Follow news website terms of service
- Platform Compliance: Ensure X.com account follows platform guidelines
- Ethical Journalism: Maintain objectivity and factual accuracy
Legal Compliance
- Use only for legitimate journalism and news sharing
- Respect copyright and fair use policies
- Follow local laws regarding automated social media activity
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
For support, questions, or feature requests:
- Issues: GitHub Issues
- Discussions: GitHub Discussions
⚡ Built for the future of automated journalism - AI-Journo helps you stay informed and share breaking news responsibly.
Metadata
Release files for xnewsbot 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| xnewsbot-0.6.0.tar.gz | 111.4 kB | Without provenance | Details for xnewsbot-0.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| xnewsbot-0.6.0-py3-none-any.whl | Python 3 | none | any | Details for xnewsbot-0.6.0-py3-none-any.whl |
Total release size: 220.0 kB
Release files / xnewsbot-0.6.0.tar.gz
| Download URL | xnewsbot-0.6.0.tar.gz |
|---|---|
| Size | 111.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4113146e80da9bbc5bdb9edd1d17d3e1d1a1483eb0d05873d8f006b8f4e6c2cb
|
|
BLAKE2b-256 checksum How to use checksums |
00b911b6f91afc680afe692de120f697832787ff20a429fb8677e539a9c59748
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Release files / xnewsbot-0.6.0-py3-none-any.whl
| Download URL | xnewsbot-0.6.0-py3-none-any.whl |
|---|---|
| Size | 108.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
39e1a346675632358cf1c808083c24565a41a14c38396da60ada58cd83744495
|
|
BLAKE2b-256 checksum How to use checksums |
71dd97dd1a06a80c9f0e539e627bde6955f721f64644127e8b61009208762df8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Security for xnewsbot 0.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.