Download the PHP package subhashladumor1/laravel-ai-docs without Composer

Laravel AI Docs

Turn any PDF, image, audio or Word document into structured, searchable intelligence — powered by GPT-5.2, Claude 4.6, or Gemini 3.1 — with a single line of Laravel code.

What Is This Package?

Imagine your users are uploading invoices, contracts, scanned receipts, meeting recordings or medical reports. You need to extract data, answer questions, generate summaries, and build searchable databases — without writing thousands of lines of AI integration code.

Laravel AI Docs handles all of that with a fluent, chainable API:

How It Works

The package sits as an intelligent layer between your Laravel app and AI providers. When you call AIDocs::pdf($file), it:

1. Validates the file (type, size, existence)
2. Extracts raw content using native parsers (smalot/pdfparser, PhpWord)
3. Detects if the document is scanned and needs OCR
4. Processes images or audio through pre-processing pipelines
5. Sends a carefully crafted prompt to your chosen AI (OpenAI, Claude, or Gemini)
6. Returns the result as a string, array, or typed DocumentResultDTO

Installation

Publish the config file:

Add your API keys to .env:

🧪 Open Source Laravel AI Docs Lab

Want to test this package before integrating it? We've built an open-source testing UI where you can upload documents, test all AI models, and experiment with the API visually!

👉 Get the Laravel AI Docs Lab on GitHub

Real-World Example 1 — Invoice Processing System

Your e-commerce platform receives thousands of supplier invoices as PDFs every day. You need to extract line items, totals, vendor names and due dates automatically.

How the data flows for this example:

Real-World Example 2 — Legal Contract Q&A Chatbot

A law firm wants to let paralegals ask plain-English questions about uploaded contracts without reading hundreds of pages.

How the RAG pipeline works:

Real-World Example 3 — Medical Report Digitization

A hospital scans paper patient forms. The images need to be converted to searchable database records.

Image OCR flow:

Real-World Example 4 — Meeting Minutes Automation

Your team records all meetings. You want automatic transcriptions and action-item summaries sent to Slack.

Real-World Example 5 — Multi-Language Document Portal

A global company receives documents in English, Arabic, French, Chinese, and Russian. Your portal needs summaries in the original language.

Language detection flow:

Real-World Example 6 — Financial Report Dashboard

A fintech app ingests quarterly earnings PDFs and extracts all financial tables for charting.

Switching AI Providers

You can switch providers per-request. No config changes needed — just chain .model() or .provider():

The Full Pipeline Explained

DocumentResultDTO — Your Data Container

Every ->result() call returns a typed DocumentResultDTO. It's immutable and holds everything your pipeline produced:

Working with Tables

Complete API Reference

Manager Methods — Available on AIDocs::

These three methods configure the active provider and language before you call an entry point. They return a cloned, immutable instance — so chains never interfere with each other.

Entry Points — What File Type to Process

Tip: Use AIDocs::pdf() for PDFs with special handling (scanned detection, page count). Use AIDocs::document() when you want one entry point for any document type.

PDFBuilder — Full Method Reference

Returned by AIDocs::pdf($path). Text is automatically extracted on construction so all methods below work immediately.

Chainable Methods (return static — can be chained)

Terminal Methods (return a final value — end the chain)

Every Useful PDFBuilder Combination

ImageBuilder — Full Method Reference

Returned by AIDocs::image($path). Unlike PDF/Document builders, text is NOT extracted on construction — it is lazily extracted when you first call a method that needs it.

Chainable Methods

Terminal Methods

Every Useful ImageBuilder Combination

AudioBuilder — Full Method Reference

Returned by AIDocs::audio($path). Audio requires OpenAI Whisper (Claude and Gemini do not support direct audio transcription).

Chainable Methods

Terminal Methods

Every Useful AudioBuilder Combination

Note: Audio transcription is only supported by the OpenAI provider (Whisper). Calling AIDocs::provider('claude')->audio(...) or AIDocs::provider('gemini')->audio(...) will throw a FileProcessingException.

DocumentBuilder — Full Method Reference

Returned by AIDocs::document($path). Handles DOCX, DOC, TXT, MD and also PDF. Text is automatically extracted on construction based on file extension.

Chainable Methods

Terminal Methods

Every Useful DocumentBuilder Combination

DocumentResultDTO — All Properties & Methods

Every ->result() call returns a DocumentResultDTO. It is immutable — values are set once and never change.

Properties

Helper Methods

Usage Examples

TableDTO — All Properties & Methods

Each item in $result->tables is a TableDTO.

Configuration Reference

After publishing (php artisan vendor:publish --tag=ai-docs-config), you can tune every aspect in config/ai-docs.php:

Testing Your Integration

The package ships a FakeAIProvider — write tests that never call real APIs:

Run all tests:

Package Architecture

License

MIT — free for personal and commercial use. See LICENSE.