Download the PHP package hassanjrao/laravel-ai-log-search without Composer
On this page you can find all versions of the php package hassanjrao/laravel-ai-log-search. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hassanjrao/laravel-ai-log-search
More information about hassanjrao/laravel-ai-log-search
Files in hassanjrao/laravel-ai-log-search
Package laravel-ai-log-search
Short Description AI-assisted, natural-language log file search for Laravel. Streams huge log files without loading them into memory and turns plain-language questions into structured filters via Gemini or any OpenAI-compatible API.
License MIT
FAQ
Example:
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 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.
Informations about the package laravel-ai-log-search
Laravel AI Log Search
AI-assisted, natural-language search over your Laravel log files — built for very large logs (hundreds of MB) that normal log viewers choke on.
Ask in plain language:
"errors that happened today" · "entries mentioning PaymentJob after 2 pm" · "critical entries related to user 4521"
The AI turns your request into a structured filter (levels, keywords, date range) — it never reads your log file. A deterministic streaming scanner then applies that filter to the file:
- Flat memory — the file is read backwards in 64 KB chunks; a 2 GB log uses the same memory as a 2 KB one.
- Newest first — results stream from the end of the file.
- Bounded requests — each request stops at a match limit and a byte-scan budget (default 50 MB), returning a byte offset so "Load older" resumes exactly where it left off.
- Multi-line aware — stack traces and context lines are grouped with their entry.
- Redaction — emails, bearer tokens, obvious secrets, and long digit runs are masked before entries reach the browser.
- Works without AI — with
driver=none(the default) the prompt is used as a plain keyword search. No API key needed to try it.
The UI is a single self-contained page (vanilla JS, no build step, no frontend framework required).
Demo
Requirements
- PHP 7.2.5+ or 8.x
- Laravel 7 – 12
Installation
The service provider is auto-discovered. Visit /ai-log-search (in the local environment it works immediately).
Authorization (required outside local)
Like Telescope, the page is open in the local environment only. Anywhere else you must define a viewAiLogSearch gate (e.g. in AuthServiceProvider::boot()):
Enable AI interpretation (optional)
Pick a driver in .env:
If the AI call fails or returns garbage, the package silently falls back to searching the raw prompt as a keyword — the page keeps working.
Custom AI provider
Bind your own implementation of Hassanjrao\AiLogSearch\Contracts\AiClient in a service provider:
completeJson(string $instruction): ?array receives the interpretation prompt and must return the decoded JSON filter (or null).
Configuration
Key options in config/ai-log-search.php:
| Option | Default | Description |
|---|---|---|
route_prefix |
ai-log-search |
URL prefix for the page and its API. |
middleware |
['web'] |
Middleware stack (the authorize middleware is always appended). |
log_dir |
storage/logs |
Directory scanned for *.log files. |
driver |
none |
gemini, openai, or none (keyword-only). |
limits.entries_per_page |
200 |
Max matching entries per request. |
limits.byte_budget |
50 MB |
Max bytes scanned per request. |
redact |
true |
Mask likely PII/secrets in returned entries. |
To customize the page itself:
HTTP API
All endpoints live under the configured prefix and honor the same authorization.
| Method | Endpoint | Body | Returns |
|---|---|---|---|
GET |
/files |
— | {files: [{name, size, size_human, modified}]} |
POST |
/query |
{file, prompt} |
interpreted filter, explanation, plus the first result page |
POST |
/results |
{file, filter, offset} |
{entries, next_offset, eof, file_size, scanned_bytes} |
offset is the byte position returned as next_offset by the previous page (0 = start from the end of the file). filter shape:
Security notes
- File names from the client are reduced to their base name and resolved with
realpath()inside the configured log directory — path traversal is not possible, and only*.logfiles are served. - The AI provider receives only the user's prompt and the file's date — never log contents.
- Client-supplied filters are re-validated server-side (levels are whitelisted).
Testing
License
MIT — see LICENSE.
All versions of laravel-ai-log-search with dependencies
ext-json Version *
illuminate/support Version ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0
illuminate/http Version ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0
guzzlehttp/guzzle Version ^6.5|^7.0
nesbot/carbon Version ^2.0|^3.0