The official CLI for Valyu.
Built for AI (or human) knowledge workers.
██╗ ██╗ █████╗ ██╗ ██╗ ██╗██╗ ██╗
██║ ██║██╔══██╗██║ ╚██╗ ██╔╝██║ ██║
██║ ██║███████║██║ ╚████╔╝ ██║ ██║
╚██╗ ██╔╝██╔══██║██║ ╚██╔╝ ██║ ██║
╚████╔╝ ██║ ██║███████╗██║ ╚██████╔╝
╚═══╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═════╝
curl -fsSL https://raw.githubusercontent.com/valyuAI/valyu-cli/main/install.sh | bashnpm install -g @valyu/cli
brew install valyuAI/cli/valyu
irm https://raw.githubusercontent.com/valyuAI/valyu-cli/main/install.ps1 | iexThen authenticate:
valyu login
Get your API key at platform.valyu.ai.
valyu search "CRISPR base editing latest breakthroughs" valyu answer "What drove Tesla's Q4 2024 earnings miss?" valyu sources --category markets
Search across web, academic, and proprietary data sources.
# Web search (default) valyu search "AI infrastructure investment" # Specify a source type valyu search paper "transformer attention mechanisms" valyu search finance "Apple AAPL earnings Q1 2026" valyu search bio "CAR-T cell therapy phase 3 trials" valyu search sec "Tesla 10-K 2024 risk factors" valyu search patent "mRNA delivery lipid nanoparticles" valyu search economics "US CPI inflation latest print" valyu search news "Fed interest rate decision" # Options valyu search paper "CRISPR" -n 20 # more results valyu search finance "MSFT" --json # pipe-friendly JSON
Get an AI-synthesized answer from real-time search results. Streams by default.
valyu answer "What is the current state of nuclear fusion commercialisation?" valyu answer "Summarise NVIDIA's competitive position in AI chips" --fast
Extract clean content from any URL — articles, PDFs, financial reports.
valyu contents https://example.com/report
valyu contents https://sec.gov/filing --summary
valyu contents https://arxiv.org/abs/2501.00001 --summary "extract methodology and results"Async deep research — produces a full report, like a junior analyst.
# Start a research task valyu deepresearch create "Global AI compute infrastructure trends" # Start and wait for completion valyu deepresearch create "CRISPR therapeutics market landscape" --mode heavy --watch # Check on a running task valyu deepresearch status <task-id> # Poll until done valyu deepresearch watch <task-id>
Research modes:
| Mode | Time | Use for |
|---|---|---|
fast |
~5 min | Quick lookups, simple questions |
standard |
~10-20 min | Balanced research (default) |
heavy |
~60 min | In-depth analysis, long reports |
max |
~90 min | Maximum depth and quality |
Browse all available data sources with pricing.
valyu sources # all 36+ sources valyu sources --category markets # financial data only valyu sources --category research # academic sources
valyu login # save API key valyu logout # remove saved key valyu whoami # show active key and profile valyu doctor # check setup and connectivity valyu open # open platform, docs, or API keys in browser
| Flag | Description |
|---|---|
--api-key <key> |
Override stored key for one request |
--json |
Force JSON output (for scripting/pipes) |
-q, --quiet |
No spinners, just JSON (implies --json) |
-p, --profile <name> |
Use a named credential profile |
Every command outputs clean JSON with --json or in non-TTY contexts:
# Pipe into jq valyu search finance "AAPL" --json | jq '.results[].title' # In CI/CD RESULTS=$(valyu answer "latest rate decision" --quiet) # With environment variable VALYU_API_KEY=your_key valyu search web "query" --json
valyu login --profile work
valyu login --profile personal
valyu search web "query" --profile workThe CLI ships with a SKILL.md file that teaches AI coding agents how to use it - no MCP server needed, 4-32x cheaper in tokens.
npx skills add @valyu/cli
Then agents can call:
Valyu(search, "CRISPR base editing")
Valyu(answer, "What drove NVDA earnings?")
Valyu(contents, "https://example.com")
36+ proprietary and public data sources across:
- Web - real-time web search
- Academic - arXiv, PubMed, bioRxiv, medRxiv
- Financial - stocks, earnings, balance sheets, cash flows, crypto, forex
- SEC - 10-K, 10-Q, 8-K filings full text
- Patents - global patent databases
- Biomedical - clinical trials, FDA drug labels, ChEMBL, DrugBank
- Economic - BLS, FRED, World Bank, USASpending
See all: valyu sources
MIT