PHPackages                             armin/ai-agent - 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. armin/ai-agent

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

armin/ai-agent
==============

Generic AI code assistant client for PHP.

08↓100%PHP

Since May 18Pushed 3w agoCompare

[ Source](https://github.com/a-r-m-i-n/ai-agent)[ Packagist](https://packagist.org/packages/armin/ai-agent)[ RSS](/packages/armin-ai-agent/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

armin/ai-agent
==============

[](#arminai-agent)

`armin/ai-agent` is a generic AI code assistant client for PHP. It ships with built-in tools for reading files, finding files, writing files, viewing images, generating images, and running local commands, while keeping the tool system open for consuming applications to register additional actions at runtime.

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

[](#requirements)

- PHP `^8.4`
- Composer

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

[](#installation)

```
composer require armin/ai-agent
```

Quick Configuration
-------------------

[](#quick-configuration)

The package reads the API key from `AI_AGENT_API_KEY` by default. The CLI reads its default model from `AI_AGENT_DEFAULT_MODEL`. Models must be configured as `provider:model`, for example `openai:gpt-5`.

The environment variable names are exposed as constants on `Armin\AiAgent\AiAgentConfig`:

- `AiAgentConfig::API_KEY_ENV_VAR`
- `AiAgentConfig::MODEL_ENV_VAR`

```
export AI_AGENT_API_KEY=your-key
export AI_AGENT_DEFAULT_MODEL=openai:gpt-5
```

Documentation
-------------

[](#documentation)

- [PHP usage](docs/php-usage.md)
- [CLI usage](docs/cli-usage.md)

Supported Providers
-------------------

[](#supported-providers)

- `openai`
- `anthropic`
- `gemini`

Notes
-----

[](#notes)

- Authentication is intentionally out of scope for this package.
- Requests are executed through Symfony AI provider bridges.
- The CLI mode is non-interactive. Use a session file if you want multi-turn history between invocations.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance62

Regular maintenance activity

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/355aa463a532a530009c06219f83ab8b20a9b80a2bc8995064b6d390c6427735?d=identicon)[ArminVieweg](/maintainers/ArminVieweg)

---

Top Contributors

[![a-r-m-i-n](https://avatars.githubusercontent.com/u/1275298?v=4)](https://github.com/a-r-m-i-n "a-r-m-i-n (36 commits)")

### Embed Badge

![Health badge](/badges/armin-ai-agent/health.svg)

```
[![Health](https://phpackages.com/badges/armin-ai-agent/health.svg)](https://phpackages.com/packages/armin-ai-agent)
```

###  Alternatives

[snowdog/frontools

Set of front-end tools for Magento 2, based on Gulp.js

4231.4M1](/packages/snowdog-frontools)[ishanvyas22/asset-mix

Asset Mix plugin for CakePHP

3376.4k2](/packages/ishanvyas22-asset-mix)

PHPackages © 2026

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