Download the PHP package atlas-php/atlas without Composer

✨ Features  ·  📚 Documentation  ·  🧪 Sandbox & Examples  ·  ⚖️ Comparison

🪐 Atlas

A unified AI SDK for Laravel — agents, tools, and 10 modalities across every major provider.

One API for OpenAI, Anthropic, Google, xAI, ElevenLabs, and any OpenAI-compatible endpoint — with no external AI dependency. Atlas runs the tool-call loop and adds optional persistence for conversations, tracking, and memory.

Every provider modality is live-tested against real provider APIs. See the API Audit.

⚡ It's this simple

No agent classes, no config. Add ->instructions() and ->withTools() when you need them, or graduate to a reusable Agent as your app grows.

🎯 Highlights

• Every modality — text, images, audio, music, SFX, video, realtime voice, embeddings, reranking, moderation. Voice, music, SFX, and video are Atlas-only.
• A real agent framework — first-class agents, sub-agents with guards and true parallel fan-out, auditable execution trees.
• Production-grade persistence — conversation memory, execution tracking, retry & branch, media assets on disk (S3/local).
• Operational services — pre-flight token counting, provider-call observability, runtime model/voice discovery.
• Control at every layer — middleware across agent, step, tool, and provider boundaries.
• Multi-provider, one API — every major provider plus any OpenAI-compatible endpoint; swap by changing a string.

💡 Why Atlas?

Plenty of AI libraries get you a response and stop there. Atlas handles everything after the happy path — the retries, errors, and tracking real apps run into.

• Tested for real, not mocked. Every modality runs against the live provider API (API Audit), and every feature ships with automated tests. What the docs say is what ships.
• Production-hardened. Automatic retries, typed exceptions, observability, and cost tracking that survives interrupted streams — the failure modes real apps hit are already handled.
• Keeps pace with the providers. New models, tools, and capabilities land fast — the CHANGELOG shows the cadence.

And where it counts, Atlas simply does more: realtime voice, video, retry & branch, pre-flight token counting, and ~50%-cheaper batch processing are all Atlas-only among Laravel AI libraries. See the full comparison →

🚀 Quick Start

Supports Laravel 11+.

Define an Agent

Build a Tool

Chat with the Agent

Speak with the Agent (Voice to Voice)

See the Voice Integration Guide for full setup instructions.

Optional: Enable Persistence

Atlas runs fully stateless by default — no database required. To unlock conversation history, execution tracking, media-asset storage, and retry & branch, publish and run the migrations:

Then turn it on in .env:

That's it — ->for($user) and ->forConversation($id) now load and persist history automatically.

✨ Features

Core generation

• Text & structured output — schema-validated JSON from any provider
• Streaming — SSE + Laravel Broadcasting, real-time chunks
• Tool calling — typed tools, multi-step loop, concurrent execution
• Reasoning — configure, stream, and persist extended thinking
• Prompt caching — cache long system prompts to cut cost
• Token counting — count input (with tools & images) before sending

Agent framework

• Agents — provider, model, instructions, and tools in one reusable class
• Sub-agents — delegation with depth/cycle guards, lineage, and parallel fan-out
• Conversations & memory — multi-turn history, retry & branch, agent memory
• Execution tracking — steps, tools, usage, and assets persisted
• Media assets — auto-stored to disk (S3/local), linked to messages
• Middleware — agent, step, tool, and provider layers
• Variable interpolation — {var} placeholders resolved at runtime
• Queues — async execution with broadcasting and callbacks

Modalities

• 10 modalities — text, images, audio, music, sound effects, video, voice, embeddings, reranking, moderation
• Realtime voice — bidirectional voice conversations with tools
• Similarity search — whole-record or chunked embeddings, diff-based re-embedding

Ecosystem & tooling

• Provider tools — web search, code interpreter, file search
• MCP — composes with Laravel MCP
• Provider discovery — list models/voices, validate keys, inspect capabilities
• Observability — trace every provider call, correlation IDs across retries
• Testing — full per-modality fakes, no API keys required
• Custom providers — OpenAI-compatible endpoints or fully custom drivers

🔌 Providers

Atlas talks to every major provider through one interface. Switch by changing a string — your agents, tools, and middleware stay the same.

First-party drivers

OpenAI · Anthropic · Google (Gemini) · xAI (Grok) · ElevenLabs · Cohere · Jina

Any OpenAI-compatible API

Ollama · Groq · DeepSeek · Together · OpenRouter · LM Studio · Mistral · Perplexity

📖 Documentation

atlasphp.org — Full guides, API reference, and examples.

• Getting Started — Installation and configuration
• Agents — Define reusable AI configurations
• Tools — Connect agents to your application
• Sub-agents — Agent-to-agent delegation, including concurrent (parallel) fan-out
• Middleware — Extend with four middleware layers
• Similarity Search — Semantic search over whole-record or chunked embeddings
• Modalities — Text, images, audio, video, voice, embeddings, and more
• Conversations — Multi-turn chat with persistence
• Voice — Real-time voice conversations
• Streaming — SSE and broadcasting
• Queue — Background execution
• Testing — Fakes and assertions

🧪 Sandbox

A fully functional chat interface demonstrating Atlas agents in action — multi-agent chat, tool calling, conversation memory, and live image/video generation. Built with Vue 3, Tailwind CSS, and a Laravel JSON API.

See the Sandbox README for setup instructions and details.

🧹 Testing and Code Quality

Atlas uses several tools to maintain high code quality:

Tool	Purpose
Pest	Testing framework
Larastan	Static analysis
Laravel Pint	Code style
API Audit	Every provider modality verified against real provider APIs
Codecov

🤝 Contributing

We welcome contributions!

Support the community by giving a GitHub star. Thank you!

Please see our Contributing Guide for details.

📄 License

Atlas is open-sourced software licensed under the MIT license.