PlugIndex

Directory / plugin

Alpaca Bot

v0.6.3 · by carmelosantana

A privately hosted WordPress AI chatbot. Chat with your own models, give them tools, and keep every conversation in your own database.

View on WordPress.orgHomepage

About this plugin

Alpaca Bot is a chat screen inside WordPress admin, talking to a model you host. Conversations stay on your site, in your own database, and only their author can open them. It runs against Ollama out of the box, or any OpenAI-compatible endpoint.

Features

  • A chat screen in wp-admin: replies stream in as they are written, with a copy button on every message and code block, “Edit and resend” on your own, and an image attached from the media library for a model that can see.
  • The same chat as a drawer on most other admin screens and as a sidebar in the block editor. The drawer carries the screen it is on, and both carry the post being edited, as chips above the composer; a chip you take off is not sent.
  • Your conversations, stored privately on your site (or not at all: the Privacy tab decides) and listed in the screen’s history.
  • Switch models per conversation; where the site allows it, your pick is remembered as your default.
  • A system prompt, per-model overrides (temperature, context window, keep-alive) and a receipt under every reply: model, tokens, time.
  • Monthly usage caps, per site and per user, with the meter behind them.
  • Tools the model can call, each switchable: fetch a web page, summarize, write a draft, and the abilities tool, which offers the WordPress abilities an administrator ticks and runs each as the chatting user.
  • Remote MCP servers under Settings › Tools: Discover tools lists a server’s tools, and the model is offered the ones you approve; Tools, and what they let the model reach says what that means.
  • Settings › Access: who may use the chat, each tool, each MCP server, the settings over REST and the shortcodes, one capability per row, with a note under a row that code sets instead.
  • A REST API under alpaca-bot/v1 (docs/api.md) and a WP-CLI command.

Requirements

  • PHP 8.4+, WordPress 6.9+, an Ollama instance (or any provider php-agents supports)

Setup

  1. Install Ollama on your localhost or server.
  2. In your WordPress admin, open Alpaca Bot > Settings and, on the Provider tab, enter the endpoint’s base URL. For Ollama it ends in /v1: http://localhost:11434/v1.
  3. Click Save Changes. The Models tab then lists what the provider serves; pick a default.

⭐️ Become a Patreon and support Alpaca Bot development. ⭐️

Usage

Read Usage in the README on GitHub.

Shortcodes

Read Shortcodes in the README on GitHub.

Support

Questions and bug reports go to the WordPress.org support forum. Say which plugin, WordPress and PHP versions you run.

For premium support, book a call: video calls, help setting up your Ollama instance or provider, troubleshooting, and onsite setup assistance.

If the plugin has been useful, star Alpaca Bot on GitHub; a star helps other site owners find it.

Made Possible By

Plugin tags