# Grep SDKs

TypeScript and Python clients for the Grep v2 API.

Breadcrumbs: [Developers](/developers) / [SDKs](/developers/sdks)

## Developer documentation
- [Developers](/developers.md)
- [api](/developers/api.md)
- [a2a](/developers/a2a.md)
- [api/v1](/developers/api/v1.md)
- [api/v2](/developers/api/v2.md)
- [api/quickstart](/developers/api/quickstart.md)
- [api/auth](/developers/api/auth.md)
- [api/idempotency](/developers/api/idempotency.md)
- [api/pagination](/developers/api/pagination.md)
- [api/webhooks](/developers/api/webhooks.md)
- [api/errors](/developers/api/errors.md)
- [mcp](/developers/mcp.md)
- [skills](/developers/skills.md)
- [sdks](/developers/sdks.md)
- [sdks/typescript/quickstart](/developers/sdks/typescript/quickstart.md)
- [sdks/typescript/reference](/developers/sdks/typescript/reference.md)
- [sdks/python/quickstart](/developers/sdks/python/quickstart.md)
- [sdks/python/reference](/developers/sdks/python/reference.md)
- [sdks/lifecycle](/developers/sdks/lifecycle.md)
- [sdks/skills](/developers/sdks/skills.md)
- [sdks/batches](/developers/sdks/batches.md)
- [sdks/loops](/developers/sdks/loops.md)
- [sdks/campaigns](/developers/sdks/campaigns.md)
- [sdks/results](/developers/sdks/results.md)
- [sdks/errors](/developers/sdks/errors.md)
- [api/agentid](/developers/api/agentid.md)

## Choose a client

Both standalone SDKs support agents, builds, runs, skills, integrations, batches, recurring loops, campaigns, cancellation, and usage. They send authenticated requests to https://api.grep.ai/api/v2 by default. An API key is required for every request.

| Feature | TypeScript / JavaScript | Python |
| --- | --- | --- |
| Distribution | @parcha/agentrun | agentrun-ai |
| Import | AgentRun, Agent, Skill | AgentRun, Agent |
| Runtime | Node.js 20.9+ | Python 3.10+ |
| Runtime dependencies | None | None |
| Execution | Async promises | Synchronous |
| Polling units | Milliseconds | Seconds |
| Artifact downloads | Blob | bytes |

## Version and availability

These pages describe version 0.2.0 and the unified v2 backend. The 0.2.0 packages and backend rollout are pending; the currently published npm 0.1.0 package does not contain this full API, and the Python PyPI release is pending. Use the reviewed 0.2.0 package artifacts against a deployment containing the unified routes until release. Changing the base URL cannot add missing routes to an older deployment.

After release, install with npm install @parcha/agentrun@0.2.0 or python -m pip install agentrun-ai==0.2.0. The Python import is agentrun, not the distribution name. Neither SDK falls back to legacy routes or retries writes automatically.

## Authentication and permissions

Keep AGENTRUN_API_KEY in your server environment. Both clients send Authorization: Bearer . Keys retain scope, ownership, and account feature checks: agent and skill management uses experts:read / experts:write, research workflows use research:read / research:write, and usage uses billing:read. Batch, campaign, and recurring access must also be enabled for the account.

Set baseURL in TypeScript or base_url in Python only to use another authorized Grep deployment. Remote URLs require HTTPS; localhost is allowed for development. Never put a secret key into browser code.

## Related documentation
- [All SDK documentation](/developers/sdks)
- [API reference](/developers/api/v2)