PHPackages                             actsmart/actsmart - 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. actsmart/actsmart

ActiveLibrary

actsmart/actsmart
=================

Intelligent Agent Construction Toolkit

0.10.5(6y ago)16851[4 issues](https://github.com/actsmart/actsmart/issues)[1 PRs](https://github.com/actsmart/actsmart/pulls)MITPHPPHP ~7.0

Since May 14Pushed 6y ago3 watchersCompare

[ Source](https://github.com/actsmart/actsmart)[ Packagist](https://packagist.org/packages/actsmart/actsmart)[ Docs](https://github.com/actsmart/actsmart)[ RSS](/packages/actsmart-actsmart/feed)WikiDiscussions development Synced 2mo ago

READMEChangelog (10)Dependencies (12)Versions (25)Used By (0)

actsmart
========

[](#actsmart)

[![Latest Version on Packagist](https://camo.githubusercontent.com/136d3a99a4344cc3d35d3aa57d278cc643c2e8c32801d565549afe50e7aadf7e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616374736d6172742f616374736d6172742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/actsmart/actsmart)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/9a5260a235d42755f4bcb7a73ffc828040dbd35f713aeeaf6fd0f42041ae5f57/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f616374736d6172742f616374736d6172742f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/actsmart/actsmart)[![Quality Score](https://camo.githubusercontent.com/33db1fa01a13754707312a8ae1300ab57de476ac002ada8dfece6b6af4e7f2be/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f616374736d6172742f616374736d6172742e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/actsmart/actsmart)[![Total Downloads](https://camo.githubusercontent.com/0194ab0165b706137b3df87d4fdd3d6b0a3b62f6837663f8dd3804ccef4093bb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616374736d6172742f616374736d6172742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/actsmart/actsmart)

About
-----

[](#about)

actSmart is an agent construction toolkit. It is an opinionated way of building agents with a focus on conversational agents (chatbots). It is the framework we use internally at [GreenShoot Labs](https://greenshootlabs.com).

Our initial focus is Slack and connecting to a number of cognitive services that we use at GreenShoot Labs.

It is very early days so much is yet to be defined.

### Agents

[](#agents)

An agent for actSmart is something that can perceive its environment through sensors and can change its environment through actuators in an effort to achieve its goals and satisfy its motivations. Read [this](https://hackernoon.com/making-artificial-intelligence-work-for-you-part-1-what-is-ai-dd7512058e0e) for a light-weight intro to the ideas.

From a web service point of view sensors receive information (e.g. messages from Slack) while actuators purposefully connect with the outside word to change its state (by asking for things to be created, updated or deleted) or to pro-actively collect information that the agent does not have.

Agents attempt to achieve goals by executing an actions or a series of actions. For example, a goal might be to mark the state of a task as done. The action to achieve this would be to connect with the API that manages tasks and request that the state of a particular task is updated to done.

As the framework evolves concepts will be more explicitly expressed (e.g. we do not currently explicitly represent goals). Did I mention it's early days.

### Conversations

[](#conversations)

actSmart uses a graph structure to provide templates of potential conversations between a user and the agent. A conversation is divided in scenes. Participants in a scene exchange utterances that will either complete the conversation or resolve the purpose of that specific scene and advance the conversation to the next scene. Scenes have preconditions and postconditions as do specific utterances within a scene. Furthermore, utterances can cause actions (as described above) to take place.

Consider, for example, a simple pizza ordering scenario. The user might start with:

"-Can I order some pizzas please?"

When actSmart receives that utterance it searches for a conversation template with an opening scene that matches that and sets that conversation as the active conversation. It then identifies how it should reply. For example:

"-How many pizzas would you like to order?"

The user replies:

"-2 pizzas please."

This user utterance completes the initial scene and move us on to a new scene where we know we need to collect the details on the pizzas (i.e. the purpose of the scene is to find out exactly what 2 pizzas the user wants and the precondition is that the user has already defined how many pizzas they need). This second scene could evolve as follows:

"-What should the first pizza be?" "-Margherita" "-And what should the second pizza be?" "-Pinneaple and ham"

and with that we complete the pizzas selection scene and can proceed to a drink ordering scene, side-orders, etc.

We will be posting actual examples once the scene structure is stable enough for it to make sense!

Install
-------

[](#install)

Via Composer

```
$ composer require actsmart/actsmart
```

Usage
-----

[](#usage)

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [GreenShoot Labs](https://greenshootlabs.com)
- [Ronald Ashri](https://twitter.com/ronald_istos)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.8% 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 ~27 days

Recently: every ~45 days

Total

17

Last Release

2488d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0518d99e4cd8b3a805b37591d12c2123e9f87ca68101ecea8c3e1c6cddb7c71f?d=identicon)[istos](/maintainers/istos)

---

Top Contributors

[![istos](https://avatars.githubusercontent.com/u/80763?v=4)](https://github.com/istos "istos (304 commits)")[![stu-greenshoots](https://avatars.githubusercontent.com/u/35454728?v=4)](https://github.com/stu-greenshoots "stu-greenshoots (55 commits)")[![acrollet](https://avatars.githubusercontent.com/u/101649?v=4)](https://github.com/acrollet "acrollet (7 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

actsmart

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/actsmart-actsmart/health.svg)

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

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[silverstripe/framework

The SilverStripe framework

7213.5M2.5k](/packages/silverstripe-framework)

PHPackages © 2026

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