Download the PHP package inceptia-io/larabrain without Composer

On this page you can find all versions of the php package inceptia-io/larabrain. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of inceptia-io/larabrain

Informations about the package larabrain

LaraBrain

Give your Laravel application self-awareness. LaraBrain scans your codebase (models, migrations, routes, controllers), builds a structured context graph, and uses an AI provider to answer natural-language questions about how your application works — with clickable links to relevant pages.

Latest Version on Packagist PHP Version

Requirements

Installation

1 — Install via Composer

Laravel will auto-discover the service provider via the extra.laravel key in composer.json. No manual provider registration is required for Laravel 10+.

2 — Publish the config file

This places config/app-brain.php in your application's config/ directory.

3 — (Optional) Publish migrations

4 — Configure environment variables

Add the variables below to your .env file. Only BRAIN_AI_DRIVER and its corresponding API key are required.

Environment Variables

All environment variables are optional unless marked required. The package reads from .env and falls back to config/app-brain.php.

AI Provider Configuration

Variable Default Description
BRAIN_AI_DRIVER openai Required. AI provider: openai, gemini, anthropic, or deepseek
OPENAI_API_KEY — OpenAI API key (e.g. sk-...). Required if BRAIN_AI_DRIVER=openai
GEMINI_API_KEY — Google Gemini API key. Required if BRAIN_AI_DRIVER=gemini
ANTHROPIC_API_KEY — Anthropic API key. Required if BRAIN_AI_DRIVER=anthropic
DEEPSEEK_API_KEY — DeepSeek API key. Required if BRAIN_AI_DRIVER=deepseek

Provider-Specific Settings

Variable Default Description
BRAIN_OPENAI_MODEL gpt-4o OpenAI model to use (e.g. gpt-4-turbo, gpt-4)
BRAIN_OPENAI_MAX_TOKENS 2048 Maximum tokens for OpenAI responses
BRAIN_OPENAI_TIMEOUT 60 Request timeout in seconds for OpenAI
BRAIN_GEMINI_MODEL gemini-1.5-pro Google Gemini model to use
BRAIN_GEMINI_MAX_TOKENS 2048 Maximum tokens for Gemini responses
BRAIN_ANTHROPIC_MODEL claude-3-5-sonnet-20241022 Anthropic model to use
BRAIN_ANTHROPIC_MAX_TOKENS 2048 Maximum tokens for Anthropic responses
BRAIN_DEEPSEEK_MODEL deepseek-chat DeepSeek model to use
BRAIN_DEEPSEEK_MAX_TOKENS 2048 Maximum tokens for DeepSeek responses

Caching

Variable Default Description
BRAIN_CACHE_ENABLED true Enable/disable the cache layer entirely
BRAIN_ASK_CACHE_CONTEXT false Cache context results per keyword to avoid re-scanning
BRAIN_CACHE_CONTEXT_TTL 3600 TTL in seconds for cached context results
BRAIN_CACHE_PREFIX brain Cache key prefix to avoid conflicts

Logging

Variable Default Description
BRAIN_ASK_LOG_QUERIES false Log every ask() call at DEBUG level with metadata
BRAIN_LOG_CHANNEL null Log channel (uses app default if null)

Web Interface

Variable Default Description
BRAIN_UI_ENABLED true Enable/disable the web chat interface
BRAIN_UI_PREFIX brain URL prefix for chat page (e.g. /brain)

Example .env

Scanning Your Codebase

Before asking questions, scan your application to build the context index:

This scans your models, migrations, routes, and controllers and stores a snapshot. Options:

Asking Questions

Use the Artisan command to ask a natural-language question:

Options:

Web Interface

LaraBrain includes a built-in web UI for asking questions directly from your browser. Access is controlled by middleware (protected by auth by default).

Standalone Chat Page

Visit the chat interface at your configured URL:

This is a full-page chat application with:

Access control: Protected by auth middleware by default. Configure in config/app-brain.php:

To make it public:

Floating Widget

Drop the widget anywhere in your admin layout for quick access without leaving the page:

The widget appears as a fixed button in the bottom-right corner. Click to open a chat panel with the same features as the standalone page.

Example: Add to your admin panel footer:

The widget respects the same middleware configuration as the chat page.

Using the Facade

You can also override keyword detection:

The AppBrainResponse object contains:

Property Type Description
query string The original question
keyword string Extracted or overridden keyword
intent Intent Detected intent enum
context ContextResult The resolved context graph
prompt string The full prompt sent to the AI
driver string The AI driver used
answer string The AI response
elapsedMs float Total time in milliseconds

Intent Detection

The package classifies each question into one of five intents before building the prompt. This focuses the AI's response on the relevant aspect of your codebase.

Intent Triggered by
Explain Workflow "how does", "explain", "walk me through", "flow", "process", "lifecycle"
Show Routes "routes", "endpoints", "url", "web route", "api route"
Describe Model "model", "schema", "fields", "fillable", "casts", "relationships"
List Dependencies "dependencies", "what uses", "what calls", "connected to", "references"
General Everything else

You can extend the keyword map at runtime:

Context Building

The Brain facade provides direct access to the context layer:

AI Providers

Four providers are built in. Switch between them with BRAIN_AI_DRIVER.

Driver Environment Key Default Model
openai OPENAI_API_KEY gpt-4o
gemini GEMINI_API_KEY gemini-1.5-pro
anthropic ANTHROPIC_API_KEY claude-3-5-sonnet-20241022
deepseek DEEPSEEK_API_KEY deepseek-chat

Per-provider model and token settings can be overridden in config/app-brain.php or via environment variables:

Custom Provider

Implement Arafat\Brain\AI\AppBrainAIInterface and register it in the config:

Configuration Reference

The full config file at config/app-brain.php includes these top-level keys:

Key Default Description
enabled true Globally enable or disable the package
cache.enabled true Enable the cache layer
cache.ttl 3600 Default cache TTL in seconds
cache.context_ttl 3600 TTL for context results specifically
cache.prefix brain Cache key prefix
ask.cache_context false Cache context results per keyword
ask.log_queries false Log each ask() call at DEBUG level
log_channel null Log channel (null uses app default)
scan.exclude vendor, node_modules, storage, etc. Paths excluded from file scanning
scan.scanners all enabled Per-scanner enable/disable flags
ai.default openai Active AI driver
ui.enabled true Enable/disable the web chat interface
ui.prefix brain URL prefix for chat page (e.g. /brain)
ui.middleware ['web', 'auth'] Middleware stack for UI routes (remove auth to make public)

Testing

With coverage:

Code quality:

License

MIT BRAIN_CACHE_ENABLED=true BRAIN_CACHE_TTL=3600 BRAIN_CACHE_PREFIX=brain BRAIN_LOG_CHANNEL=null BRAIN_QUEUE_ENABLED=false BRAIN_QUEUE_CONNECTION=default BRAIN_QUEUE_NAME=brain

laravel-brain/ ├── composer.json ├── .gitignore ├── config/ │ └── app-brain.php # Package configuration ├── database/ │ └── migrations/ │ └── 2026_01_01_000000_create_brain_tables.php ├── src/ │ ├── Brain.php # Core implementation │ ├── BrainServiceProvider.php # Laravel service provider │ ├── Contracts/ │ │ └── BrainInterface.php # Public API contract │ ├── Exceptions/ │ │ └── BrainException.php # Base package exception │ └── Facades/ │ └── Brain.php # Laravel Facade └── tests/ ├── Pest.php # Pest bootstrap ├── TestCase.php # Testbench base case ├── Feature/ # Feature tests └── Unit/ # Unit tests bash composer test

with coverage

composer test:coverage



---

## License

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

All versions of larabrain with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
illuminate/support Version ^10.0|^11.0|^12.0|^13.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package inceptia-io/larabrain contains the following files

Loading the files please wait ...