Package Exports

@valyu/cli

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@valyu/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Valyu CLI

The official CLI for Valyu.

Built for AI (or human) knowledge workers.

  ██╗   ██╗ █████╗ ██╗  ██╗   ██╗██╗   ██╗
  ██║   ██║██╔══██╗██║  ╚██╗ ██╔╝██║   ██║
  ██║   ██║███████║██║   ╚████╔╝ ██║   ██║
  ╚██╗ ██╔╝██╔══██║██║    ╚██╔╝  ██║   ██║
   ╚████╔╝ ██║  ██║███████╗██║   ╚██████╔╝
    ╚═══╝  ╚═╝  ╚═╝╚══════╝╚═╝    ╚═════╝

Install

cURL (macOS / Linux)

curl -fsSL https://get.valyu.ai | bash

Node.js

npm install -g @valyu/cli

Homebrew (macOS / Linux)

brew install valyuAI/cli/valyu

PowerShell (Windows)

irm https://get.valyu.ai/install.ps1 | iex

Then 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

Valyu CLI demo

Commands

`valyu search`

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

`valyu answer`

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

`valyu contents`

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"

`valyu deepresearch`

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

`valyu workflows`

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-flow

`valyu sources`

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

Other commands

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

Flags

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

Scripting and agents

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

Key precedence: --api-key flag → your valyu login key → VALYU_API_KEY. A logged-in key takes precedence over the env var, so you don't need to unset VALYU_API_KEY after running valyu login. VALYU_API_KEY still applies when you haven't logged in (e.g. CI).

Multiple profiles

valyu login --profile work
valyu login --profile personal
valyu search web "query" --profile work

Agent skill

The 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")

Data sources

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

License

MIT

@valyu/cli