The official CLI for Valyu.
Built for AI (or human) knowledge workers.
██╗ ██╗ █████╗ ██╗ ██╗ ██╗██╗ ██╗
██║ ██║██╔══██╗██║ ╚██╗ ██╔╝██║ ██║
██║ ██║███████║██║ ╚████╔╝ ██║ ██║
╚██╗ ██╔╝██╔══██║██║ ╚██╔╝ ██║ ██║
╚████╔╝ ██║ ██║███████╗██║ ╚██████╔╝
╚═══╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═════╝
curl -fsSL https://get.valyu.ai | bashnpm install -g @valyu/clibrew install valyuAI/cli/valyuirm https://get.valyu.ai/install.ps1 | iexThen authenticate:
valyu loginGet 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 JSONGet 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" --fastExtract 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 |
up to ~2 hrs | Maximum depth and quality |
Reusable, versioned deep research templates. A workflow bundles a prompt, research
strategy, report format, deliverables, and recommended mode with typed {variables}.
Fill in the variables and run it - the template expands into a normal deep research task.
Curated Valyu workflows (e.g. an IC memo, a drug competitive landscape, a company profile) are available to everyone; workflows you create are private to your org.
# Browse curated templates
valyu workflows list --scope valyu
valyu workflows list --vertical investment-banking
# Inspect a template and its variables
valyu workflows get ib-company-profile
# Preview the resolved prompt without spending credits
valyu workflows preview ib-company-profile --param company="NVIDIA (NVDA)"
# Run it (starts a deep research task)
valyu workflows run ib-company-profile --param company="NVIDIA (NVDA)" --watch
valyu workflows run ib-company-profile -P company="Apple" -m heavy
# Manage your own org workflows
valyu workflows create --file workflow.json
valyu workflows update my-flow --file patch.json
valyu workflows delete my-flowBrowse all available data sources with pricing.
valyu sources # all 36+ sources
valyu sources --category markets # financial data only
valyu sources --category research # academic sourcesvalyu 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" --jsonKey precedence:
--api-keyflag → yourvalyu loginkey →VALYU_API_KEY. A logged-in key takes precedence over the env var, so you don't need to unsetVALYU_API_KEYafter runningvalyu login.VALYU_API_KEYstill applies when you haven't logged in (e.g. CI).
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