How jeongujeong117-byte/ai-raider works
AI Raider is a local social-media research collector with a browser-based management UI. Its main workflow is selecting accounts and a date range, collecting Instagram/X posts, persisting posts and reactions (and optionally media), then browsing or exporting results. Separate branches collect public GitHub repositories and configured web sources. Downloaded media can enter a durable local OCR/transcription queue. The supplied source excerpts show the main runner and processing behavior; some UI routes and storage details are described only in the README, so those links cite it.
Main entry points: raider.py Local HTTP server · source_agents.py Source workers · source_tools.py Public fetch tools · github_agent.py GitHub collector
Components 28
Local interface
- Collection UI
web/index.html - Sources UI
web/sources.html - GitHub UI
web/github.html - Local HTTP server
raider.py
Social collection
- Account registry
source_manager.py - Collection runner
raider.py - Instagram adapter
raider.py - X adapter
raider.py - Media downloader
media_store.py
Other sources
- GitHub collector
github_agent.py - GitHub API client
github_agent.py - Source workers
source_agents.py - YouTube extractor
source_agents.py - News extractor
source_agents.py - Gallery extractor
source_agents.py - Hugging Face extractor
source_agents.py - Public fetch tools
source_tools.py
Persistence
- Posts and runs
raider.py - GitHub records
github_agent.py - Source records
source_agents.py - Media files
media_store.py
Local extraction
- Processing queue
post_processing.py - OCR and transcription
post_processing.py
Other components
- Researcher
- Instagram and X
- GitHub
- Public web sources
- Local OCR and speech models
Connections 34
- Researcher → Collection UI: selects range
README.md - Researcher → Sources UI: configures sources
README.md - Researcher → GitHub UI: starts collection
README.md - Collection UI → Local HTTP server: sends requests
README.md - Sources UI → Local HTTP server: sends requests
README.md - GitHub UI → Local HTTP server: sends requests
README.md - Local HTTP server → Account registry: manages accounts
README.md - Local HTTP server → Collection runner: starts collection
raider.py - Collection runner → Instagram adapter: collects posts
raider.py - Collection runner → X adapter: collects posts
raider.py - Instagram and X → Instagram adapter: provides posts
README.md - Instagram and X → X adapter: provides posts
README.md - Collection runner → Media downloader: downloads media
raider.py - Collection runner → Posts and runs: saves posts
raider.py - Media downloader → Media files: writes files
media_store.py - Collection runner → Processing queue: queues posts
raider.py - Processing queue → OCR and transcription: routes attachments
post_processing.py - OCR and transcription → Local OCR and speech models: uses models
README.md - Local HTTP server → Posts and runs: queries and exports
raider.py - Local HTTP server → Processing queue: reports status
raider.py - Local HTTP server → GitHub collector: dispatches requests
raider.py - GitHub collector → GitHub API client: searches repositories
github_agent.py - GitHub API client → GitHub: uses API
README.md - GitHub collector → GitHub records: saves records
github_agent.py - Local HTTP server → Source workers: dispatches requests
raider.py - Source workers → YouTube extractor: selects extractor
source_agents.py - Source workers → News extractor: selects extractor
source_agents.py - Source workers → Gallery extractor: selects extractor
source_agents.py - Source workers → Hugging Face extractor: selects extractor
source_agents.py - YouTube extractor → Public fetch tools: fetches public content
source_agents.py - News extractor → Public fetch tools: fetches public content
source_agents.py - Gallery extractor → Public fetch tools: fetches public content
source_agents.py - Source workers → Source records: saves results
source_agents.py - Public fetch tools → Public web sources: fetches pages
source_tools.py