PHPackages                             maximerenou/hugging-chat - 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. maximerenou/hugging-chat

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

maximerenou/hugging-chat
========================

HuggingChat client

v0.5.2(3y ago)18902[1 PRs](https://github.com/maximerenou/php-hugging-chat/pulls)PHPPHP >=7.1

Since Apr 26Pushed 3y ago1 watchersCompare

[ Source](https://github.com/maximerenou/php-hugging-chat)[ Packagist](https://packagist.org/packages/maximerenou/hugging-chat)[ RSS](/packages/maximerenou-hugging-chat/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (1)Versions (9)Used By (0)

[![HuggingChat + PHP](logo.png)](logo.png)

HuggingChat client
==================

[](#huggingchat-client)

[![License](https://camo.githubusercontent.com/850eae1099d2b05f53383473d7cd51f9bc1ab09b7d0d9e5122f1dd930efdcc6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6173686170652f6170697374617475732e737667)](https://opensource.org/licenses/MIT)[![Latest Stable Version](https://camo.githubusercontent.com/ab3f2f2d41dbff7e798730859d5651fbdcab8ee473c6b23da222002536d852c3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6d6178696d6572656e6f752f7068702d68756767696e672d63686174)](https://packagist.org/packages/maximerenou/hugging-chat)[![PHP version](https://camo.githubusercontent.com/ce952217cdd3169fb6d83aa15df7e4bc366206de16682b5f8f018754049bfab3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6d6178696d6572656e6f752f68756767696e672d636861742f706870)](https://packagist.org/packages/maximerenou/hugging-chat)[![cURL extension required](https://camo.githubusercontent.com/3b7a2ac9e7758e56b3c13782336baf3ea3b13242a9ea254785303d9c6522aa1b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6d6178696d6572656e6f752f68756767696e672d636861742f6578742d6375726c)](https://packagist.org/packages/maximerenou/hugging-chat)

This is an unofficial PHP client for **HuggingChat** (OpenAssistant's LLaMA model).

> HuggingChat API [is evolving fast](https://huggingface.co/spaces/huggingchat/chat-ui/commits/main) with recurring breaking changes. I try to keep up with it, but it may not always work as expected. Feel free to open an issue if you encounter any problem.

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

[](#installation)

```
composer require maximerenou/hugging-chat

```

Demo
----

[](#demo)

Run `examples/chat.php` to test it.

[![Prompt Demo](examples/demo.gif)](examples/demo.gif)

Usage
-----

[](#usage)

```
use MaximeRenou\HuggingChat\Client as HuggingChat;
use MaximeRenou\HuggingChat\Prompt;

$ai = new HuggingChat();

$conversation = $ai->createConversation();

// $answer - full answer
$answer = $conversation->ask(new Prompt("Hello World"));
```

 Real-time / progressive answerYou may pass a function as second argument to get real-time progression:

```
// $current_answer - incomplete answer
// $tokens - last tokens received
$final_answer = $conversation->ask($prompt, function ($current_answer, $tokens) {
    echo $tokens;
});
```

  Resume a conversationIf you want to resume a previous conversation, you can retrieve its identifiers:

```
// Get current identifiers
$identifiers = $conversation->getIdentifiers();

// ...
// Resume conversation with $identifiers parameter
$conversation = $ai->resumeConversation($identifiers);
```

  Use another modelYou can use a specific model:

```
$conversation = $ai->createConversation("bigcode/starcoder");
```

Default is OpenAssistant.

  Generate a conversation's summaryUseful to give a title to a conversation.

```
// Question asked: "Who's Einstein?"
// ...
$summary = $conversation->getSummary();
// Result: Famous genius mathematician.
```

  Turn on/off data sharingHuggingChat share your conversations to improve the model. You can turn on/off data sharing:

```
$conversation->enableSharing(); // on

$conversation->disableSharing(); // off (module default)
```

 Delete a conversation```
$conversation->delete();
```

 Handle HuggingChat errorsThe code throws exceptions when it receives an error from HuggingChat. You can therefore use a try/catch block to handle errors.

 Answers are sometimes malformed (or dumb)Answers quality depends on the model you're using.

---

#### Disclaimer

[](#disclaimer)

Using HuggingChat outside huggingface.co/chat may violate HuggingFace terms. Use it at your own risk.

###  Health Score

22

—

LowBetter than 23% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community9

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

Total

7

Last Release

1100d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/80bcf6ed37c089e47d02a7210fefb2ecd4ebc38c05491f72c0ef2a55fb0536f0?d=identicon)[maximerenou](/maintainers/maximerenou)

---

Top Contributors

[![maximerenou](https://avatars.githubusercontent.com/u/4728191?v=4)](https://github.com/maximerenou "maximerenou (11 commits)")

---

Tags

aichatbothuggingchathuggingfacellamaopenassistant

### Embed Badge

![Health badge](/badges/maximerenou-hugging-chat/health.svg)

```
[![Health](https://phpackages.com/badges/maximerenou-hugging-chat/health.svg)](https://phpackages.com/packages/maximerenou-hugging-chat)
```

###  Alternatives

[bertptrs/phpstreams

A streams library for PHP based on the Java 8 Streams API.

883.2k](/packages/bertptrs-phpstreams)[cheprasov/php-parallel

The class allows you to run multiple operations parallel in different processes and send results to the main process. Useful if you need to run multiple independent operations simultaneously, instead of sequential execution, or if you run several independent queries, for example, queries to different data bases

1712.5k5](/packages/cheprasov-php-parallel)

PHPackages © 2026

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