Skip to main content

ARGUS - Research Orchestrator

ARGUS banner

Not a search engine, not a scraper, not a wrapper. A research orchestration skill and CLI that routes any AI agent through existing open-source tools using a 5-wave methodology with cross-verification.

Philosophy: do not reinvent the wheel. Compose existing tools (yt-dlp, Firecrawl, Crawl4AI, TEx, Telerecon) into one coherent research workflow.

Quick start

ARGUS: <query>
ARGUS: compare Notion vs Obsidian
ARGUS: platform AI agents on Twitter
ARGUS: timebox EU AI Act 2024-2026
ARGUS: region AI market in Africa
ARGUS: narrow pricing model of Stripe
ARGUS: deep quantum computing startups in Europe
ARGUS: quick who is the CEO of X

Local CLI (standard library only, no install required):

python argus_search.py plan "ARGUS: compare Notion vs Obsidian"
python argus_search.py report "ARGUS: deep AI in Africa" --output ./output
python argus_search.py preview durov --limit 5
python argus_search.py verify ./output/argus-report-<slug>-<date>.md   # mandatory gate before delivery
python argus_search.py modes

Install as a package with MCP server (for agents):

pip install .              # CLI: argus
pip install .[mcp]         # MCP server: argus-mcp

MCP deployment: run the MCP server on stdio or localhost only. Never bind it to a network socket without authentication, TLS, and a path allowlist, because generate_report and verify_report perform filesystem I/O.

Contents

File Role
SKILL.md Orchestrator spec: modes, filters, routing, consent workflows, evidence pipeline
MODES.md The 7 research modes in detail
FILTERS.md The 10 filters and language presets
TOOLS.md Routing matrix and tool notes
USER_GUIDE.md Install, 5-step flow, consents, troubleshooting
DECISIONS.md Architecture decision records
CHANGELOG.md Release history
argus_search.py CLI: plan bank, consent gates, report skeleton, Telegram preview, verify gate
argus_mcp.py MCP server: list_modes, plan_research, generate_report, telegram_preview, verify_report
pyproject.toml Packaging: argus-search CLI and argus-mcp server

Golden rule

No scraping, no forums or Telegram deep search, no dark web, no restricted sources - without asking the user first and getting an explicit [Y]. Silence means SKIP, always.

Status

  • Phase 1 (build) done. Phase 2 (verify) done. Phase 3 (publish prep) done.
  • Verified 2026-10-07: 7/7 modes, 7/7 routing entries, 4/4 consents, 5/5 verification checks.
  • Full Telegram collection requires the user's own TELEGRAM_API_ID and TELEGRAM_API_HASH.

Metadata

Release files for emo-argus 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for emo-argus 1.1.0
File Size Uploaded
emo_argus-1.1.0.tar.gz 18.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for emo-argus 1.1.0
File Interpreter ABI Platform
emo_argus-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 35.3 kB

Release files / emo_argus-1.1.0.tar.gz

Download URL emo_argus-1.1.0.tar.gz
Size 18.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f5393ec6fc8cea0a8d38bde9bbfdebeadd6cee28dad7b3c20246705498054fa0
BLAKE2b-256 checksum
How to use checksums
6e1790501f368ca07423a29f3b7a0fc63f07bf6b0a1a0463e22c350084255ce5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.5

Release files / emo_argus-1.1.0-py3-none-any.whl

Download URL emo_argus-1.1.0-py3-none-any.whl
Size 16.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
61468b620fd0a158cb7b95b1fe045a76686bfb6b54f3c1d5c5f926d1a9e99e59
BLAKE2b-256 checksum
How to use checksums
09649adbe483c0954ec23d16f9beb31574f45c49d296daacbcc3c1cefb5f0798
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.5

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page