billy-sdkSimple AI for your projects

The easiest way to add AI to your Node.js apps — generate, modify, validate, analyze, extract, and execute with natural language prompts

Get Started

API Reference

View on GitHub

🤖

Multi-Provider

Supports Groq (default, free), OpenAI, and Anthropic. No vendor lock-in. Switch providers with one line of code.

🔄

Type Conversion

Automatic parsing of responses to numbers, arrays, objects, booleans, or JSON. No manual parsing needed.

🧠

Built-in Memory

Automatic conversation history via billy({ memory: 10 }). Maintain context across multiple prompts effortlessly.

⛓️

Method Chaining

Fluent API — IA.asNumber().short().create("prompt"). Compose behavior with expressive, chainable methods.

🔌

Variable Injection

Use {"{{placeholders}}"} in prompts and inject dynamic data at runtime. Template prompts like a pro.

📡

Streaming

Real-time streaming responses via IA.stream() with AsyncIterable. Consume chunks as they arrive.

📁

File & Image Handling

Extract text from PDFs and images automatically. Pass file paths directly in your prompts.

🛠️

Tool Calling

Let the AI call your own functions. Define tools with schemas and let the model decide when to use them.

⚡

CLI Ready

Manage your API key with simple CLI commands. No environment variable hassle. npx billy-sdk config set <key>

🛡️

Retry & Timeout

Built-in retry logic and configurable timeout for production reliability. Your app stays resilient.

Quick Start

bash

npm install billy-sdk

javascript

import billy from "billy-sdk";

const IA = billy();

const response = await IA.create(
  "Generate 5 creative startup ideas in the sustainability space"
);

console.log(response);

One-Minute Setup