Pica, The AI Integrations Solution

Website · Documentation · Dashboard · Changelog · X · LinkedIn

---

Pica gives every builder instant, reliable access to the tools they need—no keys, no configs, no headaches.

Why Pica?

Pica simplifies AI agent development with our four core products:

✅ OneTool – Connect agents to 100+ APIs and tools with a single SDK.
✅ AuthKit – Secure authentication for seamless tool integration.
✅ BuildKit - Empower vibe coding with integrations that work zero-shot.

Pica also provides full logging and action traceability, giving developers complete visibility into their agents’ decisions and activities. Our tools simplify building and running AI agents so developers can focus on results.

Getting started

Install

npm install @picahq/ai

Setup

1. Create a new Pica account
2. Create a Connection via the Dashboard
3. Create an API key
4. Set the API key as an environment variable: PICA_SECRET_KEY=<your-api-key>

Example Usage

Below is an example demonstrating how to integrate the Pica OneTool with the Vercel AI SDK for a GitHub use case:

import { openai } from "@ai-sdk/openai";
import { generateText } from "ai";
import { Pica } from "@picahq/ai";
import * as dotenv from "dotenv";
dotenv.config();

const pica = new Pica(process.env.PICA_SECRET_KEY!, {
  connectors: ["*"]
});

async function runAgentTask(message: string): Promise<string> {
  const system = await pica.generateSystemPrompt();

  const { text } = await generateText({
    model: openai("gpt-4.1"),
    system,
    prompt: message,
    tools: { ...pica.oneTool },
    maxSteps: 10,
  });

  return text;
}

runAgentTask("Star the repo picahq/pica with github")
  .then((text) => {
    console.log(text);
  })
  .catch(console.error);

For more use cases, visit our Use Cases Library or our Awesome Pica Repository.

Next.js Integration

⭐️ You can see a full Next.js demo here

For more examples and detailed documentation, check out our SDK documentation.

---

Running Pica locally

Important

The Pica dashboard is going open source! Stay tuned for the big release 🚀

Prerequisites

• Docker
• Docker Compose

Step 1: Install the Pica CLI

npm install -g @picahq/cli

Step 2: Initialize the Pica CLI

To generate the configuration file, run:

pica init

Step 3: Start the Pica Server

pica start

All the inputs are required. Seeding is optional, but recommended when running the command for the first time.

Example

# To start the docker containers
pica start
Enter the IOS Crypto Secret (32 characters long): xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Do you want to seed? (Y/N) y

The Pica API will be available at http://localhost:3005 🚀

To stop the docker containers, simply run:

pica stop

License

Pica is released under the GPL-3.0 license.