Download the PHP package survos/ai-chat-bundle without Composer

On this page you can find all versions of the php package survos/ai-chat-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package ai-chat-bundle

survos/ai-chat-bundle

Expose a Survos app's Symfony AI agents to chat platforms over an OpenAI-compatible endpoint, so a chat client (first: Mattermost via its Agents plugin) can @-mention them — with optional shared browser chat and voice controls. See PLAN.md.

The bundle owns the communications (OpenAI transport, auth, persona routing); each app supplies one thin ChatAgentResolverInterface. Comms first — this release ships the Mattermost wiring and an mm:post proof; the completions endpoint + agent wiring come next.

Install

Extends Survos\Kit\AbstractUxBundle; the mm:post command auto-registers.

Demo — prove the chat plumbing (mm:post)

The demo lives in demo/ — a tiny console app that posts to a Mattermost instance through the Symfony Mattermost notifier.

  1. Have a Mattermost over https. The notifier hardcodes https://, so it can't reach a plain-http local docker. Use the deployed server: https://chat.survos.com (the survos-sites/mattermost repo on Dokku).
  2. In Mattermost: create a bot (or personal access token) and grab the target channel id (the 26-char id in the channel URL, or via the API).
  3. Configure the demo:

  4. Post:

A cooler demo (later): a TUI that posts and listens, instead of a one-shot post.

Roadmap

See PLAN.md for the full design and decisions.

Shared browser composer

Include @SurvosAiChat/widget.html.twig with messages (role, text), action (POST URL), token (CSRF value), and samples (label, question). Optional placeholder and maxLength customize the composer. The widget uses Bootstrap classes and escapes all messages; it does not render model-generated HTML.

The chat Stimulus controller fills/focuses a sample question without submitting, supports Ctrl/⌘+Enter, announces pending work, and prevents duplicate submissions. The host owns authorization, CSRF validation, rate limits, retrieval, models, conversation persistence, reset, and error handling. It works with ordinary POST and redirect flows; it does not assume a newspaper, article, or database schema. Enable chat under @survos/ai-chat-bundle in the application's controllers.json when testing a locally linked checkout; published installs use Flex UX discovery.

Mastheads is the initial consumer. FF's RappNews composer informed the interaction; FF has not been migrated to this template.

Voice conversations and source links

The bundle now extends AbstractUxBundle. The optional voice controller wraps an existing asynchronous question form. FF's Ask Rapp is the first voice consumer. No provider keys, retrieval logic or newspaper-specific prompts live in the bundle.

Resolve its identifier with survos_stimulus('ai-chat-bundle', 'voice') and attach it using stimulus_controller. Values: url (transcription POST), speechUrl (speech POST), token (CSRF), rate (playback speed, 0.75–1.75, default 1), name (spoken assistant label), and captureUrl (asset('@survos/ai-chat-bundle/src/audio/capture_processor.js')). Include @SurvosAiChat/voice_controls.html.twig inside that element, and attach the controller's form and input targets to the host form/question field. The optional review template variable defaults true; turning review off enables a continuous conversation with automatic submission, spoken replies and interruption.

Wire host events to questionStarted, answerReceived, and answerFailed with stimulus_action. answerReceived expects event.detail = {text, mode}; mode is voice for conversational prose or text for an answer needing spoken adaptation. The host should read element.dataset.answerMode when submitting its question. Wire visibilitychange@document to visibilityChanged to pause in the background. For replay, put data-voice-answer and data-answer-mode on the answer wrapper, data-voice-text on its text, and a play target / readAnswer click action on its button. These markers are independent of the generated controller identifier.

Transcription receives multipart audio (16 kHz mono WAV, up to 55 seconds, under 1.8 MB) and _token, returning JSON {text} or {error}. Speech receives form fields text, mode, _token, returning browser-playable audio or JSON {error}. The host owns authentication, validation, rate limits and providers. An input's maxlength and browser validity rules are respected.

Hands-free playback monitors an echo-cancelled microphone. Sustained input stops the reply and keeps 400 ms of pre-roll, preserving the first syllable. Brief noises do not trigger an interruption. Stop/disconnect/backgrounding releases the microphone and cancels pending playback. This requires HTTPS (or localhost), AudioWorklet and microphone permission. Acoustic echo suppression depends on the device/browser; real speakerphone/car testing is still needed. It is not a full-duplex realtime API.

Attach the optional links controller to an answer/history region to open HTTP(S) sources in a new tab with noopener noreferrer and an icon-external SVG. It handles restored history and streamed DOM additions; fragment links remain in-page.

Run the audio/lifecycle tests with node --test bu/ai-chat-bundle/tests/js/*.test.mjs from the monorepo root.


All versions of ai-chat-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.4
survos/kit-bundle Version ^2.5
symfony/framework-bundle Version ^8.1
symfony/console Version ^8.1
symfony/http-client Version ^8.1
symfony/notifier Version ^8.1
symfony/mattermost-notifier Version ^8.0
symfony/ai-agent Version ^1.0.0-beta1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package survos/ai-chat-bundle contains the following files

Loading the files please wait ...