Setup Guide

Complete guide to setting up emby for your development environment.

Environment Setup

1. Store Your API Key Securely

Linux/macOS
Windows
.env File

Add to your shell configuration file:

# ~/.bashrc or ~/.zshrc
export EMBY_API_KEY="your-api-key-here"

Then reload:

source ~/.bashrc
# or
source ~/.zshrc

Or use a .env file:

echo "EMBY_API_KEY=your-api-key-here" >> .env

PowerShell:

[System.Environment]::SetEnvironmentVariable("EMBY_API_KEY", "your-api-key-here", "User")

Command Prompt:

setx EMBY_API_KEY "your-api-key-here"

Create a .env file in your project root:

EMBY_API_KEY=your-api-key-here

Python:

from dotenv import load_dotenv
load_dotenv()

JavaScript:

require('dotenv').config()

Add .env to your .gitignore to avoid committing secrets.

2. Install SDK

Python
JavaScript / TypeScript
Go
Other Languages

pip install openai python-dotenv

npm install openai dotenv

go get github.com/sashabaranov/go-openai

3. Configure Your Client

Python
JavaScript
TypeScript
Go

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://dev.emby.ai/v1",
    api_key=os.getenv("EMBY_API_KEY")
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://dev.emby.ai/v1",
  apiKey: process.env.EMBY_API_KEY
})

const response = await client.chat.completions.create({
  model: "gpt-4",
  messages: [{ role: "user", content: "Hello!" }]
})

console.log(response.choices[0].message.content)

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://dev.emby.ai/v1",
  apiKey: process.env.EMBY_API_KEY
})

const response = await client.chat.completions.create({
  model: "gpt-4",
  messages: [{ role: "user", content: "Hello!" }]
})

console.log(response.choices[0].message.content)

package main

import (
    "context"
    "fmt"
    "os"

    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig(os.Getenv("EMBY_API_KEY"))
    config.BaseURL = "https://dev.emby.ai/v1"
    client := openai.NewClientWithConfig(config)

    resp, err := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model: openai.GPT4,
            Messages: []openai.ChatCompletionMessage{
                {
                    Role:    openai.ChatMessageRoleUser,
                    Content: "Hello!",
                },
            },
        },
    )

    if err != nil {
        fmt.Println(err)
        return
    }

    fmt.Println(resp.Choices[0].Message.Content)
}

For more details on chat completions, see our Chat Completion SDK Documentation.

Project Setup

For New Projects

Create project directory

mkdir my-ai-project
cd my-ai-project

Initialize project

# Python
python -m venv venv
source venv/bin/activate
pip install openai python-dotenv

# JavaScript
npm init -y
npm install openai dotenv

Create .env file

echo "EMBY_API_KEY=your-key-here" > .env
echo ".env" >> .gitignore

Create first script

See First Request Guide

For Existing Projects

client = OpenAI(
    base_url="https://dev.emby.ai/v1",
    api_key="your-emby-key"
)

That’s it. All existing code continues to work.

Verify Setup

cURL

curl https://dev.emby.ai/v1/chat/completions \
  -H "Authorization: Bearer $EMBY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Say setup successful!"}],
    "max_tokens": 10
  }'

Troubleshooting

API key not found

Verify EMBY_API_KEY is set and reload your shell.

Authentication failed (401)

Ensure the key is valid and has no extra spaces.

Connection timeout

Check firewall, VPN, and network connectivity.

Next Steps

Text Generation

Build your first AI application

API Reference

Complete API documentation

Models Catalog

Browse all available models

To discover all documentation pages, fetch: https://docs.emby.io/llms.txt

Quickstart

Core Features

Guides

Environment Setup

1. Store Your API Key Securely

2. Install SDK

3. Configure Your Client

Project Setup

For New Projects

For Existing Projects

Verify Setup

Troubleshooting

Next Steps

Text Generation

API Reference

Models Catalog

Quickstart

Core Features

Guides

​Environment Setup

​1. Store Your API Key Securely

​2. Install SDK

​3. Configure Your Client

​Project Setup

​For New Projects

​For Existing Projects

​Verify Setup

​Troubleshooting

​Next Steps

Text Generation

API Reference

Models Catalog

Environment Setup

1. Store Your API Key Securely

2. Install SDK

3. Configure Your Client

Project Setup

For New Projects

For Existing Projects

Verify Setup

Troubleshooting

Next Steps