PHPackages                             moontechs/filamentphp-openai-management - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. moontechs/filamentphp-openai-management

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

moontechs/filamentphp-openai-management
=======================================

OpenAI files and batches management

0.4.10(1y ago)1661[1 issues](https://github.com/moontechs/filamentphp-openai-management/issues)AGPL-3.0PHPPHP ^8.1

Since Sep 13Pushed 1y agoCompare

[ Source](https://github.com/moontechs/filamentphp-openai-management)[ Packagist](https://packagist.org/packages/moontechs/filamentphp-openai-management)[ Docs](https://github.com/moontechs/filamentphp-openai-management)[ RSS](/packages/moontechs-filamentphp-openai-management/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (18)Used By (0)

OpenAI files and batches management
===================================

[](#openai-files-and-batches-management)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c86e893b0f726036d7adc41f1884d2ef86417c8cfd13d2dd1baea816e5d408bb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f6f6e74656368732f66696c616d656e747068702d6f70656e61692d6d616e6167656d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/moontechs/filamentphp-openai-management)[![Total Downloads](https://camo.githubusercontent.com/8f0b6d3ef3d369961833ecba8ca2d7cf7c93e58418fde6129dfb58a1cd46fe3c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f6f6e74656368732f66696c616d656e747068702d6f70656e61692d6d616e6167656d656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/moontechs/filamentphp-openai-management)

[![files_list](./screenshots/files_list.png)](./screenshots/files_list.png)

This package is used to easily manage files and batches via the OpenAI API. The flow is described [here](https://platform.openai.com/docs/guides/batch/overview).

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require moontechs/filamentphp-openai-management
```

You need to publish and run the migrations with:

```
php artisan vendor:publish --tag="filamentphp-openai-management-migrations"
php artisan migrate
```

You can publish the config file with:

```
php artisan vendor:publish --tag="filamentphp-openai-management-config"
```

This is the contents of the published config file:

```
return [
    'disk' => 'local', // you can customize used disk and upload/download folders
    'directory' => 'openai-files',
    'download-disk' => 'local',
    'download-directory' => 'openai-files-downloads',

    'select-options' => [
        'file-purpose' => [
            'batch' => 'batch',
            'assistants' => 'assistants',
            'fine-tune' => 'fine-tune',
        ],
        'batch-endpoint' => [
            '/v1/chat/completions' => '/v1/chat/completions',
            '/v1/embeddings' => '/v1/embeddings',
            '/v1/completions' => '/v1/completions',
        ],
    ],
];
```

Usage
-----

[](#usage)

Add a plugin to your Panel Provider

```
use Moontechs\OpenAIManagement\OpenAIManagementPlugin;

->plugins([
    new OpenAIManagementPlugin,
])
```

### Jobs

[](#jobs)

[Schedule](https://laravel.com/docs/11.x/scheduling) the following CLI commands:

- `php artisan openai-management:files:update` - uploads new files to an OpenAI storage and updates already uploaded files statuses
- `php artisan openai-management:batches:update` - sends files batch processing requests and updates statuses of the old requests. In case there are no batches in progress, it will send the next batch process request.
- `php artisan openai-management:batches:download-processed-files` - downloads already processed batches (files)

### UI (step by step flow)

[](#ui-step-by-step-flow)

1. **Add a project**
    - Reffer to the OpenAI [documentation](https://help.openai.com/en/articles/9186755-managing-your-work-in-the-api-platform-with-projects) to create new projects or obtain the ID and [key](https://help.openai.com/en/articles/9186755-managing-your-work-in-the-api-platform-with-projects#h_9ac8d4e902) of an existing one.
    - Note: The OpenAI key will be encrypted. Do not regenerate the Laravel `APP_KEY`.

[![files_list](./screenshots/create_project.png)](./screenshots/create_project.png)

2. **Upload files**
    - Check the [documentation](https://platform.openai.com/docs/guides/batch/getting-started) to understand the file structure.
    - Multiple file uploads are supported.
    - Tags are for internal use only and do not affect API calls.

[![upload_files](./screenshots/files_list.png)](./screenshots/files_list.png)

3. **Request Batch Processing**
    - If a file is in the `processed` status you can request batch processing.

[![edit_file](./screenshots/edit_file.png)](./screenshots/edit_file.png)

4. **Check Batch Status**
    - Batch processing can take up to 24 hours. You can check the batch status.

[![batch_view](./screenshots/batch_view.png)](./screenshots/batch_view.png)

5. **Download Processed Files**
    - When the batch is completed, a background job downloads the files to the server. You can then download them locally (a download button will appear).

[![edit_file_batch_completed](./screenshots/edit_file_batch_completed.png)](./screenshots/edit_file_batch_completed.png)

Credits
-------

[](#credits)

- [Moontechs](https://github.com/moontechs)
- [All Contributors](../../contributors)

License
-------

[](#license)

The AGPL-3.0 License. Please see [License File](LICENSE.md) for more information.

###  Health Score

22

—

LowBetter than 23% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

17

Last Release

592d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/60574a1638aef5279e9547cc7f44d28f6017ad4e056c92056c6653f42d3d034d?d=identicon)[mkoziy](/maintainers/mkoziy)

---

Top Contributors

[![mkoziy](https://avatars.githubusercontent.com/u/3823545?v=4)](https://github.com/mkoziy "mkoziy (35 commits)")

---

Tags

filament-pluginfilamentphplaravellaravel-packageopeanaiopenai-uiphpphp8laravellaravel-packageopenaifilamentphpopenai-managementfilamentphp-pluginopenai-ui

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/moontechs-filamentphp-openai-management/health.svg)

```
[![Health](https://phpackages.com/badges/moontechs-filamentphp-openai-management/health.svg)](https://phpackages.com/packages/moontechs-filamentphp-openai-management)
```

###  Alternatives

[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[relaticle/custom-fields

User Defined Custom Fields for Laravel Filament

15828.6k](/packages/relaticle-custom-fields)[jiten14/jitone-ai

jitone-ai is a powerful FilamentPHP plugin that integrates AI-powered features directly into your Filament forms.

213.1k](/packages/jiten14-jitone-ai)[codewithdennis/filament-lucide-icons

A Filament plugin that integrates Lucide icons, allowing you to use them seamlessly across Filament forms, tables, actions, and more.

4529.4k2](/packages/codewithdennis-filament-lucide-icons)[lara-zeus/popover

Zeus Popover is filamentphp component to show a Popover with custom content in tables and infolist

2968.2k3](/packages/lara-zeus-popover)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
