COLORS.chat network
colorschat.com · YouTube colors.chat · Order now terminal.glass · Deploy
jondurbin — Advanced Synthetic Instruction Tuning

Run Airoboros Without Sending Queries to the Cloud

Airoboros is a synthetic instruction dataset and model series that scales the self-instruct methodology to its limits — thousands of carefully categorized instruction types across coding, reasoning, creative writing, and domain knowledge. Deploy privately via Ollama with complete data control.

Get Deployment Quote Deployment Guide

What Is Airoboros?

Airoboros is an open-source project by jondurbin that takes the self-instruct paradigm — demonstrated by Stanford Alpaca — and pushes it substantially further. Where Alpaca generated 52,000 instructions in a handful of categories, Airoboros generates synthetic instruction data across dozens of carefully defined categories: coding, mathematical reasoning, creative writing, scientific question answering, role-play, legal reasoning, medical information, and many more.

The Airoboros framework generates this data systematically, using GPT-4 as the generation engine and extensive prompt engineering to ensure diversity, complexity, and quality across categories. The result is a dataset and fine-tuning approach that produces models with broader and more consistent coverage of instruction types than either Alpaca's simpler approach or WizardLM's complexity-focused Evol-Instruct methodology.

Airoboros models have been released on multiple base models — Llama 2 7B, 13B, and 70B — with the methodology producing strong results across all three scale points. The 70B variant in particular was a standout in the community for its broad capability and the quality of its creative and reasoning outputs, achieved entirely through fine-tuning rather than architectural changes.

What makes Airoboros different: Most instruction-tuned models are either general (covering many tasks shallowly) or specialized (covering fewer tasks deeply). Airoboros attempts genuine breadth with genuine depth — systematic data generation across a wide taxonomy of instruction types, each with its own prompting strategy designed to produce high-quality examples. The result is a model that handles unusual instruction types better than models trained on less carefully structured data.

Airoboros secondary visual

Source: Wikimedia Commons


Instruction Categories

Airoboros's training data spans a deliberately wide taxonomy. This breadth is intentional — the goal is a model that handles unusual or domain-specific instructions without the gaps that plague models trained on more uniform datasets.

CodingPython, JS, SQL, algorithms
MathematicsStep-by-step reasoning
Creative WritingFiction, poetry, scripts
Scientific QABiology, chemistry, physics
Legal ReasoningCase analysis, statutes
Medical InfoClinical knowledge
Role-PlayCharacter consistency
SummarizationDocument condensing
TranslationLanguage conversion
ClassificationCategorization tasks
Trivia / QAFactual recall
Contextual QADocument-grounded
RiddlesLateral reasoning
Writing CritiqueEditing feedback
PlanningMulti-step task planning
DebateArgumentation

Model Variants

Airoboros L2 7B

7B Parameters — Llama 2

The entry-level Airoboros deployment. Fine-tuned from Llama 2 7B on the full Airoboros synthetic dataset. Runs on consumer GPUs with 6GB VRAM. Good broad instruction coverage for personal and small-team use.

Airoboros L2 13B

13B Parameters — Llama 2

The mid-tier variant. Noticeably better reasoning, creative output, and domain knowledge than 7B. Fits in 10–12GB VRAM. The practical performance sweet spot for most Airoboros deployments.

Airoboros L2 70B

70B Parameters — Llama 2

The flagship model. Broad, deep instruction coverage with output quality approaching frontier model performance on many task types. Requires 48GB+ VRAM. The choice for organizations with GPU infrastructure that want best-available open-weight instruction following.


What Airoboros Does Well

Unusual Instruction Types

Most instruction-tuned models are trained on relatively uniform data — they handle common question-answering and writing tasks well but degrade on less frequent instruction types. Airoboros's systematic category coverage means it handles unusual requests — lateral thinking puzzles, structured argumentation, technical domain questions — with less degradation than models trained on narrower distributions.

Creative and Role-Play Tasks

Airoboros received specific attention for the quality of its creative writing and role-play outputs. The training data in these categories was generated with particular care for consistency, voice, and narrative coherence — and this shows in output that maintains character and context better than many alternatives.

Domain-Specific Knowledge Application

Scientific, legal, and medical instruction categories in the Airoboros dataset give these models exposure to domain-specific reasoning patterns that general-purpose models often lack. For professionals in these fields using a private local assistant, this translates to more useful responses on domain-specific queries.

Research and Dataset Methodology

For researchers studying synthetic data generation and instruction tuning, Airoboros is a primary source — the dataset generation code is public, the methodology is documented, and the results are reproducible. It represents one of the most systematic approaches to synthetic instruction data in the open-source ecosystem.


Airoboros vs. Similar Instruction Models

Model Data Approach Category Breadth Standout Strength
Airoboros 13B Systematic synthetic (many categories) Very broad Unusual task types, creative, domain knowledge
Alpaca 7B Self-instruct (simple) Narrow Historical reference only
WizardLM 2 7B Evol-Instruct (progressive complexity) Moderate Complex multi-step instructions
Zephyr 7B DPO preference alignment General Direct, honest chat responses
Llama 3.1 8B Instruct RLHF + SFT (Meta) Broad Strongest general capability at 8B

Hardware Requirements

Model VRAM Required RAM (CPU) Notes
Airoboros L2 7B ~5–6 GB ~12 GB Consumer GPU — fast interactive use
Airoboros L2 13B ~10–12 GB ~24 GB Mid-range GPU (RTX 3090/4080 class)
Airoboros L2 70B ~48 GB+ ~96 GB Multi-GPU or high-VRAM server

Deploying Airoboros via Ollama

# Airoboros 7B — consumer GPU
ollama pull airoboros-l2-7b

# Airoboros 13B — mid-range GPU
ollama pull airoboros-l2-13b

# Airoboros 70B — server GPU
ollama pull airoboros-l2-70b

# Launch Open WebUI
docker run -d -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://localhost:11434 \
  ghcr.io/open-webui/open-webui:main

# API test
curl http://localhost:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"airoboros-l2-13b","messages":[{"role":"user","content":"Explain quantum entanglement to a software engineer"}]}'

Use Cases

Private Knowledge Worker Assistant

Airoboros's broad category coverage makes it effective as a general-purpose private assistant for knowledge workers whose tasks span domains — research, writing, summarization, analysis — without sending queries to cloud services.

Creative Writing and Content

Writers and content creators benefit from Airoboros's strong creative category training. Fiction, scripts, dialogue, and structured creative prompts produce notably more coherent and contextually consistent output than many general-purpose alternatives.

Domain Professional Support Tool

Legal professionals, clinicians, and scientists querying a private model for domain-specific reasoning benefit from Airoboros's training on legal, medical, and scientific instruction categories — keeping sensitive professional queries on-premise.

Research on Synthetic Data

Teams studying instruction tuning methodology, synthetic data generation, or the relationship between data diversity and model capability have a transparent, reproducible reference implementation in the Airoboros framework.

Multi-Task Internal Applications

Internal tools that need a model to handle diverse task types — document Q&A, content generation, structured data extraction, summarization — benefit from Airoboros's breadth over models optimized for narrower task distributions.

Homelab Power Users

Homelab enthusiasts who want maximum capability breadth from a locally-running model find Airoboros compelling — particularly the 13B variant, which delivers strong performance across an unusually wide range of task types on accessible hardware.


Deployment Options We Offer

Single-User Workstation (7B or 13B)

Airoboros configured with Ollama and Open WebUI on your existing machine. We handle model selection based on your GPU, configure it as a persistent service, and verify performance across the task types you care about most.

Team Server Deployment (13B or 70B)

Multi-user Open WebUI deployment with user management, model access controls, and network configuration. The 70B variant for organizations with GPU infrastructure that need Airoboros's breadth at maximum quality.

Request Deployment Quote    View Deployment Guide