PHPackages                             tigusigalpa/manus-ai-php - 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. [API Development](/categories/api)
4. /
5. tigusigalpa/manus-ai-php

ActiveLibrary[API Development](/categories/api)

tigusigalpa/manus-ai-php
========================

🚀 Manus AI PHP SDK - Complete library for integration with Manus AI API. Easy integration of Manus AI agent into PHP applications with Laravel support. Task automation, AI agents, file management. Full documentation, code examples, API support.

v2.0.0(2w ago)15301[1 issues](https://github.com/tigusigalpa/manus-ai-php/issues)MITPHPPHP ^8.2

Since Nov 12Pushed 2w agoCompare

[ Source](https://github.com/tigusigalpa/manus-ai-php)[ Packagist](https://packagist.org/packages/tigusigalpa/manus-ai-php)[ Docs](https://github.com/tigusigalpa/manus-ai-php)[ RSS](/packages/tigusigalpa-manus-ai-php/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (5)Versions (4)Used By (0)

Manus AI PHP SDK
================

[](#manus-ai-php-sdk)

[![Manus AI PHP SDK](https://camo.githubusercontent.com/a26e6a46eb4a26ebabcbfc9b3bc9ecfe08bf1455576b3cf745a7d6d97dd8f7a0/68747470733a2f2f692e706f7374696d672e63632f704c36544c5943742f6d616e75732d61692d6170692d7068702d73646b2e706e67)](https://camo.githubusercontent.com/a26e6a46eb4a26ebabcbfc9b3bc9ecfe08bf1455576b3cf745a7d6d97dd8f7a0/68747470733a2f2f692e706f7374696d672e63632f704c36544c5943742f6d616e75732d61692d6170692d7068702d73646b2e706e67)

**PHP SDK for [Manus AI](https://manus.ai) API v2 — works standalone or with Laravel**

[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT)[![PHP Version](https://camo.githubusercontent.com/b5d4f7901c58ad1ddfff679966f426cc25a9354bab763846b9a7276c2feab4e0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e322d626c7565)](https://www.php.net/)[![Laravel](https://camo.githubusercontent.com/96eb4e217eedaf3bfd6b6dfcdea02676b5e7c77c0cdf1fd22c9fabac0560ead9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d38253743392537433130253743313125374331322d6f72616e6765)](https://laravel.com/)

---

> **⚠️ Breaking Changes:** Version 2.0+ uses Manus API v2 with significant changes. See [Migration Guide](#migration-from-v1) below.

Overview
--------

[](#overview)

A PHP SDK for the [Manus AI](https://manus.ai) platform API v2. Covers the full API: task management, multi-turn conversations, file uploads, webhooks, projects, skills, and connectors. Includes Laravel service provider, facade, and Artisan commands out of the box.

Built on PHP 8.2+ with type hints, tested with PHPUnit, follows PSR-4/PSR-12.

### Use cases

[](#use-cases)

- **Enterprise apps** — error handling, type safety, structured responses
- **Chatbots** — conversational interfaces via the chat task mode
- **Data processing** — document analysis, report generation, data extraction
- **Workflow automation** — delegate repetitive tasks to the AI agent
- **SaaS products** — embed AI features into your platform
- **Education** — AI-assisted learning tools
- **Mobile backends** — server-side AI processing for mobile apps

Table of Contents
-----------------

[](#table-of-contents)

- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
    - [Basic Usage](#basic-usage)
    - [Task Management](#task-management)
    - [File Management](#file-management)
    - [Webhooks](#webhooks)
    - [Laravel Integration](#laravel-integration)
- [API Reference](#api-reference)
- [Examples](#examples)
- [Testing](#testing)
- [Contributing](#contributing)
- [License](#license)

Features
--------

[](#features)

### Core

[](#core)

- **Full Manus AI API v2 coverage** — all endpoints implemented
- Task management — create, monitor, update, delete tasks with new message format
- **Multi-turn conversations** — `sendMessage()` for interactive dialogues
- **Task lifecycle** — `listMessages()` to poll progress, `stopTask()`, `confirmAction()`
- File handling — upload, attach (file\_id, file\_url, file\_data), manage
- Webhooks — receive real-time notifications on task lifecycle events
- **Projects & Skills** — group tasks, enable specific skills
- **Connectors** — integrate external services
- Multi-model support — Manus 1.6, Lite, and Max

### New in v2

[](#new-in-v2)

- **Message-based API**: Structured content format for tasks
- **Task polling**: Track progress with event messages
- **Interactive tasks**: Confirm actions when agent needs approval
- **Enhanced metadata**: `agent_status`, `share_visibility`, Unix timestamps
- **Cursor pagination**: Efficient pagination for tasks and files
- **Skills & Connectors**: Per-task configuration
- **Projects**: Organize related tasks

### Laravel

[](#laravel)

- Service provider, facade, dependency injection
- Artisan commands for task management
- Config publishing via `vendor:publish`
- API key management through `.env`

### Quality

[](#quality)

- Error handling with detailed exception messages
- Full PHP 8.2+ type hints (IDE autocomplete, static analysis)
- PHPUnit test suite
- PSR-4 autoloading, PSR-12 code style

### Developer experience

[](#developer-experience)

- Documented methods with examples
- Ready-to-run example scripts
- Helper classes for attachments, agent profiles, webhooks

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Composer
- Guzzle HTTP client (^7.8)
- Laravel 8+ (optional, for Laravel integration)

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

[](#installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require tigusigalpa/manus-ai-php
```

### 2. Get your API key

[](#2-get-your-api-key)

1. Visit [Manus AI](https://manus.im) and create an account
2. Go to [API Integration Settings](http://manus.im/app?show_settings=integrations&app_name=api)
3. Copy your API key

### 3. Quick start

[](#3-quick-start)

```