JSPM

automatic1111-provider

0.1.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 60
  • Score
    100M100P100Q58549F
  • License MIT

A TypeScript provider for the Vercel AI SDK that enables image generation using AUTOMATIC1111 Stable Diffusion WebUI

Package Exports

  • automatic1111-provider

Readme


title: Automatic1111 description: Automatic1111 Provider for the AI SDK

Automatic1111

AUTOMATIC1111 is a popular web interface for Stable Diffusion that provides a comprehensive set of features for image generation. The Automatic1111 provider for the AI SDK enables seamless integration with locally hosted AUTOMATIC1111 instances while offering unique advantages:

  • Local Control: Full control over your image generation with local Stable Diffusion models
  • No API Costs: Generate unlimited images without per-request charges
  • Model Flexibility: Use any Stable Diffusion checkpoint
  • Privacy: All generation happens locally on your hardware
  • Community Models: Access to thousands of community-created models from Civitai and HuggingFace

Learn more about AUTOMATIC1111's capabilities in the AUTOMATIC1111 Documentation.

Setup

You need to have AUTOMATIC1111 running with the --api flag enabled. Start your AUTOMATIC1111 instance with:

# Windows
./webui.bat --api

# Linux/Mac
./webui.sh --api

The Automatic1111 provider is available in the automatic1111-provider module. You can install it with:

# pnpm
pnpm add automatic1111-provider

# npm
npm install automatic1111-provider

# yarn
npm install automatic1111-provider

Provider Instance

To create an Automatic1111 provider instance, use the createAutomatic1111 function:

import { createAutomatic1111 } from 'automatic1111-provider';

const automatic1111 = createAutomatic1111({
  baseURL: 'http://127.0.0.1:7860', // Your AUTOMATIC1111 instance
});

Image Models

The Automatic1111 provider supports image generation through the image() method:

// Basic image generation
const imageModel = automatic1111.image('v1-5-pruned-emaonly');

// With custom model
const sdxlModel = automatic1111.image('sd_xl_base_1.0');

Examples

Basic Image Generation

import { automatic1111 } from 'automatic1111-provider';
import { experimental_generateImage as generateImage } from 'ai';

const { images } = await generateImage({
  model: automatic1111.image('v1-5-pruned-emaonly'),
  prompt: 'A beautiful sunset over mountains',
  size: '512x512',
});

Advanced Configuration

const { images } = await generateImage({
  model: automatic1111.image('realistic-vision-v4'),
  prompt: 'Portrait of a wise old wizard with a long beard',
  n: 2,
  seed: 12345,
  providerOptions: {
    automatic1111: {
      negative_prompt: 'blurry, ugly, deformed, low quality',
      steps: 40,
      cfg_scale: 8.5,
      sampler_name: 'DPM++ SDE Karras',
      styles: ['photorealistic', 'detailed'],
      check_model_exists: true,
    }
  }
});

Provider Options

The Automatic1111 provider supports the following options for customizing image generation:

Available Options

Option Type Default Description
negative_prompt string undefined What you don't want in the image
steps number 20 Number of sampling steps
cfg_scale number 7 CFG (Classifier Free Guidance) scale
sampler_name string "Euler a" Sampling method
denoising_strength number undefined Denoising strength for img2img (0.0-1.0)
styles string[] undefined Apply predefined styles
check_model_exists boolean false Verify model exists before generation

Model Management

The provider automatically detects available models from your AUTOMATIC1111 instance. To use a model:

  1. Place your .safetensors or .ckpt model files in the models/Stable-diffusion/ folder
  2. Restart AUTOMATIC1111 or refresh the models list in the web interface
  3. Use the exact model name (without file extension) in the provider

Additional Resources