PHPackages                             naymyomhan/hello-cat - 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. [Image & Media](/categories/media)
4. /
5. naymyomhan/hello-cat

ActiveLibrary[Image & Media](/categories/media)

naymyomhan/hello-cat
====================

Package to get random cat images from internet 😺

1.1.0(1y ago)13MITPHPPHP >=8.0

Since Nov 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/naymyomhan/hello-cat)[ Packagist](https://packagist.org/packages/naymyomhan/hello-cat)[ RSS](/packages/naymyomhan-hello-cat/feed)WikiDiscussions main Synced 1mo ago

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

Hello Cat
=========

[](#hello-cat)

 [![Hello Cat Logo](resources/hello-cat.png)](resources/hello-cat.png)

A simple Laravel package to get random cat images. This package provides two main functions to retrieve a single cat image or multiple images with optional breed filters.

 [![Hello Cat Logo](resources/screenshot.png)](resources/screenshot.png)

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

[](#installation)

To install the package via Composer, use:

```
composer require naymyomhan/hello-cat
```

After installation, publish the configuration file to set up your API key:

```
php artisan vendor:publish --tag=hello-cat
```

Set your `CAT_API_KEY` in the `.env` file:(optional)

```
CAT_API_KEY=your-cat-api-key-here

```

Usage
-----

[](#usage)

This package provides two main classes: `Cat` and `CatGroup`.

### 1. Get a Single Random Cat Image

[](#1-get-a-single-random-cat-image)

You can use the `Cat` class to fetch a single random cat image.

```
use Naymyomhan\HelloCat\Cat;

$cat = new Cat();
$response = $cat->image();
```

Example JSON Response

```
{
    "success": true,
    "message": "OK",
    "data": {
        "image": "https://cdn2.thecatapi.com/images/abc.jpg",
        "width": 500,
        "height": 400
    }
}
```

### 2. Get Multiple Random Cat Images

[](#2-get-multiple-random-cat-images)

The `CatGroup` class allows you to retrieve multiple random cat images with optional breed filtering.

```
use Naymyomhan\HelloCat\CatGroup;

$catGroup = new CatGroup();
$response = $catGroup->images(5, 'beng'); // Fetch 5 images of 'beng' breed
```

Example JSON Response

```
{
    "success": true,
    "message": "OK",
    "data": [
        {
            "url": "https://cdn2.thecatapi.com/images/abc.jpg",
            "width": 500,
            "height": 400
        },
        {
            "url": "https://cdn2.thecatapi.com/images/xyz.jpg",
            "width": 600,
            "height": 450
        }
        // Additional images
    ]
}
```

### Credits

[](#credits)

This package uses [The Cat API](https://thecatapi.com/) to fetch random cat images. A big thank you to them for providing such an awesome service!

### Error Handling

[](#error-handling)

The `CatGroup` class allows you to retrieve multiple random cat images with optional breed filtering.

```
{
    "success": false,
    "message": "Something went wrong"
}
```

License
-------

[](#license)

This package is open-source software licensed under the MIT license.

### Additional Notes

[](#additional-notes)

- Make sure to replace `"your-cat-api-key-here"` with an actual API key from [The Cat API](https://thecatapi.com/).
- Customize the package configuration as needed, especially if you have more environment settings.

This `README.md` file provides clear instructions for installation, configuration, and usage of the package's two functions.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity45

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

2

Last Release

541d ago

### Community

Maintainers

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

---

Top Contributors

[![naymyomhan](https://avatars.githubusercontent.com/u/116763630?v=4)](https://github.com/naymyomhan "naymyomhan (5 commits)")

### Embed Badge

![Health badge](/badges/naymyomhan-hello-cat/health.svg)

```
[![Health](https://phpackages.com/badges/naymyomhan-hello-cat/health.svg)](https://phpackages.com/packages/naymyomhan-hello-cat)
```

###  Alternatives

[opentok/opentok

OpenTok is a platform for creating real time streaming video applications, created by TokBox.

1413.0M10](/packages/opentok-opentok)[daun/statamic-placeholders

Generate low-quality image placeholders for lazyloading Statamic assets

106.6k](/packages/daun-statamic-placeholders)[daun/statamic-mux

Seamless video encoding and streaming using Mux on Statamic sites

132.3k](/packages/daun-statamic-mux)[justbetter/statamic-image-optimize

Image optimization after upload

1315.2k](/packages/justbetter-statamic-image-optimize)

PHPackages © 2026

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