README

MetaAI is a PHP library designed to seamlessly interact with Meta's AI APIs, which power the backend of meta.ai. This library simplifies the complexities of authentication and communication, offering a user-friendly interface for sending queries and receiving responses from Meta AI.

This project is inspired by and builds upon the excellent work of Strvm, originally implemented in Python.

With MetaAI, you can effortlessly prompt the AI with a message and receive real-time responses directly in your PHP applications.

No API key is required.

Key Features:

Internet-connected AI: MetaAI leverages real-time capabilities (powered by Bing), enabling you to receive up-to-date responses.
Powered by Llama 3 LLM: Utilizes Meta's latest Llama 3 large language model for high-quality responses.

Important

This project does not yet support image generation.

Installation

Install the Meta AI API library using Composer:

composer require adaiasmagdiel/meta-ai-api

Getting Started

Basic Usage

require_once __DIR__ . "/vendor/autoload.php";

use AdaiasMagdiel\MetaAI\Client;

$client = new Client();
$response = $client->prompt("What's the date and weather in Itaituba, Pará, today?");

echo $response->message . PHP_EOL;

Streaming Responses

Enable streaming to receive responses in real-time:

require_once __DIR__ . "/vendor/autoload.php";

use AdaiasMagdiel\MetaAI\Client;

$client = new Client();
$response = $client->prompt("Tell me about the latest tech news.", stream: true);

foreach ($response as $chunk) {
    var_dump($chunk);
}

Terminal Stream Viewer

Create a terminal stream viewer to display responses in a formatted way:

Steps:

Include the autoload file;
Import the Client class;
Create a Client instance;
Send a request with streaming;
Initialize the line counter;
Iterate over the response stream;
Move the cursor to the top;
Format the message;
Display the message in the terminal;
Update the line counter.

require_once __DIR__ . "/vendor/autoload.php";

use AdaiasMagdiel\MetaAI\Client;

$client = new Client();

// Send a prompt to the API with streaming enabled
$response = $client->prompt(
    "Who is Bruce Wayne?", 
    stream: true
);

// Initialize line counter
$lines = 0;

// Iterate over the response stream
foreach ($response as $chunk) {
    // Move cursor to top of previous lines, if necessary
    $esc = $lines > 0 ? "\x1B[{$lines}F" : "\r";

    // Format message to 75 characters per line
    $message = wordwrap($chunk->message, 75, "\n", true);

    // Display message in terminal
    echo $esc . $message;
    flush(); // Ensure output is displayed immediately

    // Update line counter
    $lines = substr_count($message, "\n");
}

License

This project is licensed under the terms of the GNU General Public License v3.

Copyright

AdaiasMagdiel/meta-ai-api: A reverse-engineered API wrapper for MetaAI in PHP, based on the work of [Strvm](https://github.com/Strvm/meta-ai-api/)

Copyright (C) 2024 Adaías Magdiel

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

Additional Licensing Information

For detailed information about licensing terms specific to Llama 3, please refer to Meta’s official Llama 3 License.

adaiasmagdiel / meta-ai-api

Maintainers

Details