ensemblai

Python client and CLI for EnsemblAI — software ecosystem intelligence for PyPI and npm: download analytics, month-over-month growth, dependency structure, and corporate ownership across millions of packages with multi-year daily history.

Requires a Pro-plan API key. Create an account, subscribe, and mint a key at https://www.ensemblai.com/settings/api-keys. Prefer an AI agent? Connect Claude Code, Cursor, or Codex to the MCP server instead — see https://www.ensemblai.com/docs/agents.

Install

pip install ensemblai        # or: uv pip install ensemblai

Quickstart

from ensemblai import Client

ea = Client()  # reads ENSEMBLAI_API_KEY from the environment

numpy = ea.package("numpy")
print(numpy["package_name"], numpy.get("latest_downloads"))

for row in ea.top(limit=10, ecosystem="npm"):
    print(row)

trend = ea.time_series(["requests", "httpx"], granularity="monthly")

Pass the key explicitly if you'd rather not use the environment:

ea = Client(api_key="ek_live_...", ecosystem="npm")

CLI

export ENSEMBLAI_API_KEY=ek_live_...

ensemblai pkg numpy
ensemblai top --eco npm --limit 10
ensemblai search "http client"
ensemblai compare requests httpx aiohttp
ensemblai companies --limit 20

Methods

The full surface is documented in the OpenAPI schema.

Configuration

License

MIT