PHPackages                             caraxes/try-on - 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 & Helpers](/categories/utility)
4. /
5. caraxes/try-on

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

caraxes/try-on
==============

A Laravel package for try-on processing.

v0.0.10(9mo ago)050MITPHPCI passing

Since Feb 27Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/AmirMahdi-for/try-on)[ Packagist](https://packagist.org/packages/caraxes/try-on)[ RSS](/packages/caraxes-try-on/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (11)Used By (0)

🎭 Try-On Laravel Package
========================

[](#-try-on-laravel-package)

Welcome to the **Try-On Laravel Package**! 🚀 This package allows you to process virtual try-on requests with ease using external services.

⚠️ Prerequisite
---------------

[](#️-prerequisite)

This package relies on the **Fal.AI Try-On API** ([Fal.AI Try-On](https://fal.ai/models/fashn/tryon/api)) for processing virtual try-on requests. To use this package, you must have access to the Fal.AI API. Please ensure you have registered for an API key and have the necessary credentials before proceeding with the installation.

📦 Installation
--------------

[](#-installation)

You can install the package via Composer:

```
composer require caraxes/try-on
```

Then, publish the configuration file:

```
php artisan vendor:publish --tag=config --provider="TryOn\Providers\TryOnServiceProvider"
```

⚙️ Configuration
----------------

[](#️-configuration)

Add the required environment variables to your `.env` file:

```
CATEGORY_IDENTIFIER_API=
CATEGORY_IDENTIFIER_TOKEN=
TRY_ON_SERVICE_TOKEN=
TRY_ON_SERVICE_API=
```

Ensure that the `TRY_ON_SERVICE_API` variable points to the **Fal.AI Try-On API**.

🚀 Usage
-------

[](#-usage)

### Getting Clothing Category

[](#getting-clothing-category)

Use the `TryOnRepository` to classify a clothing item:

```
$repository = app(\TryOn\Repositories\TryOnRepository::class);
$category = $repository->getCategory('T-shirt');
echo $category; // Outputs: tops, bottoms, or one-pieces
```

### Virtual Try-On

[](#virtual-try-on)

To process a try-on request:

```
$parameters = [
    'message' => [
        'productTitle' => 'Jeans',
        'image' => 'https://example.com/model.jpg',
        'productImage' => 'https://example.com/jeans.jpg'
    ]
];

$result = $repository->tryOn(1, $parameters);
print_r($result);
```

🛠️ Features
-----------

[](#️-features)

✅ Classifies clothing into categories (tops, bottoms, one-pieces)
✅ Sends images for virtual try-on processing
✅ Retrieves and tracks the try-on process status
✅ Stores results in the database asynchronously

🏗 Running Migrations
--------------------

[](#-running-migrations)

```
php artisan migrate
```

🏗 Queue Processing
------------------

[](#-queue-processing)

To handle speech recognition requests asynchronously:

```
php artisan queue:work
```

📜 License
---------

[](#-license)

This package is open-source and licensed under the **MIT License**. 🎉

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Feel free to submit issues or pull requests. Let's make virtual try-ons better together! 💡

📞 Support
---------

[](#-support)

For support, please open an issue on GitHub or contact me personally via email at ****.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance58

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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 ~17 days

Recently: every ~38 days

Total

10

Last Release

279d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f8719c61ab19a500f5d982df143f2e18d39cacd9cb4952c568f099984d44cb1f?d=identicon)[jackal](/maintainers/jackal)

---

Top Contributors

[![AmirMahdi-for](https://avatars.githubusercontent.com/u/97610864?v=4)](https://github.com/AmirMahdi-for "AmirMahdi-for (50 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/caraxes-try-on/health.svg)

```
[![Health](https://phpackages.com/badges/caraxes-try-on/health.svg)](https://phpackages.com/packages/caraxes-try-on)
```

###  Alternatives

[components/modernizr

Modernizr is a JavaScript library that detects HTML5 and CSS3 features in the user's browser.

10254.3k8](/packages/components-modernizr)

PHPackages © 2026

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