> ## Documentation Index
> Fetch the complete documentation index at: https://docs.builderbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Setup Guide

> This guide will walk you through setting up AI capabilities in your application using the Builder Box.

## Prerequisites

* Bun installed
* OpenRouter API key
* Next.js project with the Builder Box

## Environment Setup

1. Create a `.env.local` file in your `apps/server` folder:

```bash theme={null}
# OpenRouter API Key
OPENROUTER_API_KEY=your_api_key_here
```

2. Install required dependencies:

```bash theme={null}
bun add ai openai @ai-sdk/openrouter
```

## Configuration

### 1. OpenRouter Setup

Create a new file at `lib/openrouter.ts`:

```typescript theme={null}
import { OpenRouter } from '@ai-sdk/openrouter';

export const openrouter = new OpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY!,
  defaultModel: 'gpt-4o-mini',  // or any other model you want to use
});
```

## Usage Example

Here's a simple example of using the AI SDK in a server action:

```typescript theme={null}
// app/actions/ai.ts
'use server';

import { streamText } from 'ai';
import { openrouter } from '@/lib/openrouter';

export async function TextStream(prompt: string) {

 const result = streamText({
		model: openrouter("gemini-1.5-flash"),
		messages: [
      {
        role: "user",
        content: prompt,
      },
    ],
	}); // streamText is a function from the ai package

  return result;
}
```

## Next Steps

* Learn about [OpenRouter Integration](./open-router)
* Explore [AI Components](./components)

## Troubleshooting

### Common Issues

1. **API Key Not Found**
   * Ensure your `.env.local` file is in the correct location
   * Verify the API key is correctly set

2. **Model Not Available**
   * Check if the model is supported by OpenRouter
   * Verify your API key has access to the model

3. **Rate Limiting**
   * Monitor your API usage
   * Implement rate limiting in your application

## Support

If you encounter any issues, please:

1. Check the [OpenRouter Documentation](https://openrouter.ai)
2. Review the [Vercel AI SDK Documentation](https://sdk.vercel.ai)
3. Open an issue in our GitHub repository