Laravel SDK — Stable

Talk to your database

Drop an AI chat widget into your admin panel. Your users query, create, update and delete data using plain language — powered by a ReAct agent with multi-layer security.

Get StartedView on GitHub
$composer require botovis/botovis-laravel
Ask anything about your data…
Enterto send·Escto close

Features

Everything you need,nothing you don’t

Built for developers building admin panels and dashboards. Botovis turns complex database interactions into simple conversations.

SELECTINSERTUPDATEDELETE

Natural Language CRUD

Users search, count, aggregate, create, update and delete records by typing — no SQL, no forms.

ReAct Agent

Multi-step reasoning: Think → Act → Observe. Parallel tool calling for complex queries in fewer steps.

Write Protection

All write ops require explicit user confirmation. No accidental changes.

Role-Based Security

Multi-layer auth with schema filtering. Define roles, table access, read/write perms per user.

Real-Time Streaming

Server-Sent Events with a live reasoning timeline. Users see each step as the agent thinks.

Zero-Dep Widget

Web Component with Shadow DOM — works everywhere. React and Vue 3 wrappers included.

Multi-LLM

OpenAI, Anthropic (Claude), or local Ollama. Switch providers with a single config change.

i18n Built-In

English and Turkish out of the box. Easily extendable.

How It Works

The ReAct loop

Think → Act → Observe → Repeat. The agent reasons step by step until it has a complete, verified answer.

Ask

User sends a question

"How many orders per status?"
Think

Agent plans its approach

"I need to group orders by status"
Act

Execute the right tools

group_records(orders, status)
Observe

Analyze & respond

[{pending: 42}, {shipped: 315}]

Built-in Tools

search_recordsRead

Filters, sorting, column selection

count_recordsRead

Count with conditions

aggregate_recordsRead

SUM, AVG, MIN, MAX

group_recordsRead

Group by column

list_tablesRead

Tables & columns

create_recordWrite

Requires confirmation

update_recordWrite

Requires confirmation

delete_recordWrite

Requires confirmation

Quick Start

Up and running in
under 5 minutes

A single Composer package, one config file, one Blade directive.

Step 01

Install

bash
composer require botovis/botovis-laravel
Step 02

Publish & Migrate

bash
php artisan vendor:publish --tag=botovis-config
php artisan vendor:publish --tag=botovis-assets
php artisan migrate
Step 03

Configure LLM

env
# .env
BOTOVIS_LLM_DRIVER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

Supports OpenAI, Anthropic (Claude), and Ollama (local).

Step 04

Discover Models

bash
php artisan botovis:models --all

Lists all Eloquent models with a ready-to-paste config snippet.

Example output — paste into config/botovis.php:

php
'models' => [
    \App\Models\Order::class => ['create', 'read', 'update', 'delete'],
    \App\Models\Product::class => ['create', 'read', 'update', 'delete'],
    \App\Models\Customer::class => ['read'],
    \App\Models\User::class => ['read'],
],

💡 Remove models you don't need, or limit permissions per model.

Step 05

Add Widget

blade
{{-- In your Blade layout --}}
@botovisWidget
Step 06

Verify

bash
php artisan botovis:discover   # See discovered tables
php artisan botovis:chat       # Test in terminal

Visit your app and click the chat button. That's it.

Need more details? Check out the full documentation for configuration, security, custom tools, and more.

Architecture

One core,
every framework

Botovis has a framework-agnostic core that powers all integrations. Currently available for Laravel — with Node.js, .NET, and Python on the roadmap.

Widget

Chat UI that embeds in any page

@botovis/widgetStable
Vanilla JS chat component

Framework Integration

Server-side bridge between your app and the core

botovis/botovis-laravelStable
Laravel — Eloquent, Auth, Blade, Artisan
@botovis/nodePlanned
Node.js — Express / Fastify
botovis/dotnetPlanned
.NET — ASP.NET Core / Entity Framework
botovis/pythonPlanned
Python — Django / FastAPI

Core

Framework-agnostic ReAct agent & tool engine

botovis/coreStable
Agent loop, tool registry, context management
Widget talks to Framework Integration via SSE streamingFramework Integration delegates to Core through a service interfaceCore is pure PHP, zero framework dependencies

Start talking to
your database today

Botovis is free, open-source, and MIT-licensed. Requires PHP ≥ 8.1 and Laravel 10, 11, or 12.

View on GitHubQuick Start Guide
8
Built-in tools
3
Packages
< 5m
Setup time
MIT
License