laravel-ai-orbit

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #android #machine-learning #rust #linux #docker #macos #windows #awesome #awesome-list #pytorch #open-source

laravel-ai-orbit

(★ 32)

Standalone observability dashboard and developer playground for the Laravel AI SDK. Zero build steps. Telescope for your AI agents.

laravel-ai-orbit 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
 Laravel
 AI Orbit
</h1>

The Intelligent Control Tower for the Laravel AI SDK

---

**Laravel AI Orbit** is a standalone observability dashboard and developer playground for the official [Laravel AI SDK](https://github.com/laravel/ai) (`laravel/ai` v0.8.x). Think of it as **Telescope for your AI agents** — a polished, real-time window into everything your agents are doing, with powerful tools to test, compare, and optimize them.

Built for Laravel 12+ and PHP 8.3+, Orbit installs in seconds, requires **zero frontend build steps**, and ships with a gorgeous glassmorphism UI in both dark and light modes.

---

## Features

| Category | Feature | Description |
|----------|---------|-------------|
| **Observability** | Dashboard | At-a-glance stats for conversations, runs, messages, tokens, and agent breakdowns with configurable time periods |
| | Conversations | Searchable thread list with advanced filters, bookmarks, and chat-style message timeline with raw JSON inspector |
| | Runs | Observability for one-off SDK prompts and non-conversation AI operations with search, filters, and detail views |
| | Traces | Visual execution timeline with per-step latency and expandable tool call details |
| **Playground** | Agent Sandbox | Interactive chat with any discovered agent. Intelligent dependency resolution auto-detects Eloquent models, container bindings, and scalars |
| | Live Overrides | Override system prompt, model, provider, temperature, and max tokens on the fly |
| | Multi-turn Chat | Persistent conversation sessions with the `RemembersConversations` trait |
| **Prompt Lab** | Side-by-Side | Compare up to 3 provider+model combinations on the same prompt |
| | Auto-Tagging | Automatically labels fastest, cheapest, most concise, and best-value responses |
| | Session History | Browse and revisit all past comparison sessions |
| **Usage & Cost** | Pricing Matrix | Editable per-model pricing rules with token cost configuration |
| | Analytics | Historical cost breakdowns by agent, model, and provider with interactive charts |
| | Budget Alerts | Configurable thresholds with per-alert recipient lists, provider-specific pricing, and queued email notifications |
| | Provider Health | Monitor success rates, latency (with P50/P95/P99 percentiles), and error counts per AI provider from merged conversation + run data |
| **Security** | PII Detection | Built-in scanner detects emails, phones, SSNs, credit cards, and API keys in message payloads |
| | Data Retention | Configurable retention policies with dry-run previews and auto-cleanup of stale conversations |
| | Access Audit | Full activity log of dashboard access attempts |
| **Dev Tools** | Pest Export | Export conversations to Pest PHP test cases with one click |
| | JSONL Export | Export in OpenAI fine-tuning format for model training |
| | CSV Export | Export conversation data for spreadsheet analysis |
| | Prompt Library | Save, tag, and reuse prompts with full-text search |
| | Global Search | Search across all conversations, prompts, and bookmarks |
| | Agent Health | Score agents by response quality, tool usage, and error rates |

---

## Screenshots

<img src="https://raw.githubusercontent.com/ashrafic/laravel-ai-orbit/main/art/screenshots/dashboard.png" alt="Dashboard Overview" width="100%">

Dashboard — Real-time stats, token breakdowns, and agent analytics

<img src="https://raw.githubusercontent.com/ashrafic/laravel-ai-orbit/main/art/screenshots/playground.png" alt="Agent Playground" width="100%">

Playground — Discover and test all your agents in one place

<img src="https://raw.githubusercontent.com/ashrafic/laravel-ai-orbit/main/art/screenshots/sandbox.png" alt="Agent Sandbox" width="100%">

Sandbox — Interactive chat with live parameter overrides and tool inspection

<img src="https://raw.githubusercontent.com/ashrafic/laravel-ai-orbit/main/art/screenshots/prompt-lab.png" alt="Prompt Lab" width="100%">

Prompt Lab — Compare models side-by-side on the same prompt

---

## Installation

Requires PHP 8.3+, Laravel 12+, and the [Laravel AI SDK](https://github.com/laravel/ai) installed with migrations run.

```bash
composer require ashrafic/laravel-ai-orbit
```

After installing Orbit, publish its assets, configuration, and migrations using the `ai-orbit:install` Artisan command. After installing Orbit, you should also run the `migrate` command to create the tables needed to store Orbit's data:

```bash
php artisan ai-orbit:install
php artisan migrate
```

Visit `/ai-orbit` in your browser.

> Orbit reads directly from the SDK's `agent_conversations` and `agent_conversation_messages` tables, and also captures one-off SDK runs to its own `orbit_ai_runs` table. If SDK tables don't exist yet, you'll see a friendly setup banner.

---

## Configuration

The `ai-orbit:install` command publishes the configuration file for you. To publish only the configuration file:

```bash
php artisan vendor:publish --tag=ai-orbit-config
```

| Key | Default | Description |
|-----|---------|-------------|
| `path` | `ai-orbit` | Dashboard URI prefix |
| `auth_guard` | `web` | Authentication guard |
| `middleware` | `['web']` | Route middleware stack |
| `domain` | `null` | Custom subdomain |
| `back_to_app_url` | `/` | "Back to App" link target |
| `agent_directories` | `['app/AI/Agents', 'app/Ai/Agents']` | Scanned agent discovery paths |
| `registry_cache_ttl` | `3600` | Agent metadata cache duration (seconds) |
| `prompt-lab.max_slots` | `3` | Max models per Prompt Lab comparison |
| `prompt-lab.timeout_seconds` | `120` | Request timeout per comparison slot |
| `budget.enabled` | `true` | Budget alert system toggle |
| `budget.notification_channels` | `['mail']` | Alert notification channels |
| `observability.enabled` | `true` | Listen to Laravel AI SDK events for run capture and budget monitoring |
| `observability.store_runs` | `true` | Persist one-off SDK runs to `orbit_ai_runs` |
| `observability.capture_text_payloads` | `true` | Capture prompt/response text in run records |
| `observability.max_payload_length` | `10000` | Max characters for stored text payloads |
| `observability.excluded_operations` | `[]` | Operation names to exclude from observability |
| `audit.enabled` | `true` | Audit & PII scanning toggle |
| `audit.retention_days` | `90` | Default data retention period |

---

## Authorization

By default, Orbit is accessible only in the `local` environment.

### Gate (Recommended)

```php
use Illuminate\Support\Facades\Gate;

Gate::define('viewAiOrbit', function ($user) {
    return $user->isAdmin();
});
```

### Middleware & Guard

```php
// config/ai-orbit.php
'middleware' => ['web', 'auth'],
'auth_guard' => 'web',
```

---

## Customization

```bash
# Override any Blade view
php artisan vendor:publish --tag=ai-orbit-views

# Override config
php artisan vendor:publish --tag=ai-orbit-config

# Publish compiled assets
php artisan vendor:publish --tag=ai-orbit-assets
```

Published views land in `resources/views/vendor/ai-orbit/`.

---

## Documentation

Full documentation is available at **[ashrafic.github.io/laravel-ai-orbit](https://ashrafic.github.io/laravel-ai-orbit/)**.

---

## Testing

```bash
composer test          # Pest test suite
./vendor/bin/pint      # Code style (PSR-12)
./vendor/bin/phpstan analyse  # Static analysis (level 8)
```

---

## License

MIT License. See [LICENSE](LICENSE) for details.

---

Built with care by <a href="https://ashraficlabs.com">Ashrafic Labs</a>

laravel-ai-orbit

laravel-ai-orbit 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

laravel-ai-orbit

laravel-ai-orbit 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README