{"id":30134640,"url":"https://github.com/mattermost/mattermost-plugin-agents","last_synced_at":"2026-03-06T02:53:57.951Z","repository":{"id":161153258,"uuid":"635850823","full_name":"mattermost/mattermost-plugin-agents","owner":"mattermost","description":"Mattermost Agents plugin supporting multiple LLMs","archived":false,"fork":false,"pushed_at":"2025-08-07T13:20:06.000Z","size":32048,"stargazers_count":178,"open_issues_count":40,"forks_count":54,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-08-07T14:34:23.899Z","etag":null,"topics":["ai","llm","mattermost","mattermost-plugin"],"latest_commit_sha":null,"homepage":"https://mattermost.com/copilot","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattermost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.enterprise","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-05-03T15:30:35.000Z","updated_at":"2025-07-31T08:15:11.000Z","dependencies_parsed_at":"2024-03-21T19:27:51.778Z","dependency_job_id":"5d67e2c2-9795-4114-ac3b-cd5f8715cf33","html_url":"https://github.com/mattermost/mattermost-plugin-agents","commit_stats":null,"previous_names":["mattermost/mattermost-plugin-ai","mattermost/mattermost-plugin-agents"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/mattermost/mattermost-plugin-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattermost","download_url":"https://codeload.github.com/mattermost/mattermost-plugin-agents/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-agents/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269373072,"owners_count":24406316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","llm","mattermost","mattermost-plugin"],"created_at":"2025-08-10T21:18:12.755Z","updated_at":"2025-12-15T13:08:05.010Z","avatar_url":"https://github.com/mattermost.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Mattermost Agents Plugin [![Download Latest Master Build](https://img.shields.io/badge/Download-Latest%20Master%20Build-blue)](https://github.com/mattermost/mattermost-plugin-ai/releases/tag/latest-master)\n\nThe Mattermost Agents Plugin integrates AI capabilities directly into your [Mattermost](https://github.com/mattermost/mattermost) workspace. **Run any local LLM** on your infrastructure or connect to cloud providers - you control your data and deployment.\n\n\u003c/div\u003e\n\n![The Mattermost Agents AI Plugin is an extension for mattermost that provides functionality for self-hosted and vendor-hosted LLMs](img/mattermost-ai-llm-access.webp)\n\n## Key Features\n\n- **Multiple AI Assistants**: Configure different agents with specialized personalities and capabilities\n- **Thread \u0026 Channel Summarization**: Get concise summaries of long discussions with a single click\n- **Action Item Extraction**: Automatically identify and extract action items from threads\n- **Meeting Transcription**: Transcribe and summarize meeting recordings\n- **Semantic Search**: Find relevant content across your Mattermost instance using natural language\n- **Smart Reactions**: Let AI suggest contextually appropriate emoji reactions\n- **Direct Conversations**: Chat directly with AI assistants in dedicated channels\n- **Flexible LLM Support**: Use local models (Ollama, vLLM, etc.), cloud providers (OpenAI, Anthropic, Azure), or any OpenAI-compatible API\n\n## Documentation\n\nComprehensive documentation is available in the `/docs` directory:\n\n- [User Guide](docs/user_guide.md): Learn how to interact with AI features\n- [Admin Guide](docs/admin_guide.md): Detailed installation and configuration instructions\n- [Provider Setup](docs/providers.md): Configuration for supported LLM providers\n- [Feature Documentation](docs/features/): Detailed guides for individual features\n\n## Installation\n\n1. Download the latest release from the [releases page](https://github.com/mattermost/mattermost-plugin-ai/releases). You can also download the **experimental** [latest master](https://github.com/mattermost/mattermost-plugin-ai/releases/tag/latest-master)\n2. Upload and enable the plugin through the Mattermost System Console\n3. Configure your desired LLM provider settings\n\n### System Requirements\n\n- Mattermost Server versions:\n  - v10.0 or later recommended\n  - v9.11+ (ESR)\n- PostgreSQL database with pgvector extension for semantic search capabilities\n- Network access to your chosen LLM provider\n\n## Quick Start\n\nAfter installation, complete these steps to get started:\n\n1. Navigate to **System Console \u003e Plugins \u003e Agents**\n2. Create an agent and configure it with your LLM provider credentials\n3. Set permissions for who can access the agent\n4. Open the Agents panel from any channel using the AI icon in the right sidebar\n5. Start interacting with your AI assistant\n\nFor detailed configuration instructions, see the [Admin Guide](docs/admin_guide.md).\n\n## Integration\n\n### Bridge Client\n\nThe plugin provides a Go client library for other Mattermost plugins and the Mattermost server to interact with the AI plugin's LLM Bridge API. This allows you to easily add AI capabilities to your own plugins or server-side features.\n\nSee the [Bridge Client README](public/bridgeclient/README.md) for installation and usage instructions.\n\n## Development\n\n### Prerequisites\n\n- Go 1.24+\n- Node.js 20.11+\n- Access to an LLM provider (OpenAI, Anthropic, etc.)\n\n### Local Setup\n\n1. Setup your Mattermost development environment by following the [Mattermost developer setup guide](https://developers.mattermost.com/contribute/server/developer-setup/). If you have a remote mattermost server you want to develop to you can skip this step. \n\n2. Setup your Mattermost plugin development environment by following the [Plugin Developer setup guide](https://developers.mattermost.com/integrate/plugins/developer-setup/).\n\n3. Clone the repository:\n```bash\ngit clone https://github.com/mattermost/mattermost-plugin-ai.git\ncd mattermost-plugin-ai\n```\n\n4. **Optional**. If you are developing to a remote server, setup environment variables to deploy:\n```bash\nMM_SERVICESETTINGS_SITEURL=http://localhost:8065\nMM_ADMIN_USERNAME=\u003cYOUR_USERNAME\u003e\nMM_ADMIN_PASSWORD=\u003cYOUR_PASSWORD\u003e\n```\n\n5. Run deploy to build the plugin\n```bash\nmake deploy\n```\n\n### Other make commands\n\n- Run `make help` for a list of all make commands\n- Run `make check-style` to verify code style\n- Run `make test` to run the test suite\n- Run `make e2e` to run the e2e tests\n- Run `make evals` to run prompt evaluations interactively (with TUI)\n- Run `make evals-ci` to run prompt evaluations in CI mode (non-interactive)\n\n### Benchmark Tests\n\nThe streaming code has benchmark tests to measure performance and detect regressions:\n\n```bash\n# Run all streaming benchmarks\ngo test -bench=. -benchmem ./llm/... ./streaming/...\n\n# Run specific benchmark\ngo test -bench=BenchmarkStreamToPost -benchmem ./streaming/...\n\n# Run with CPU profiling\ngo test -bench=BenchmarkReadAll -cpuprofile=cpu.prof ./llm/...\n```\n\nBenchmarks cover:\n- `ReadAll()` stream consumption with varying response sizes\n- `TokenUsageLoggingWrapper` interception overhead\n- `StreamToPost()` full processing pipeline with WebSocket events\n\n### Multi-Provider Evaluation Support\n\nThe evaluation system supports testing with multiple LLM providers: OpenAI, Anthropic, and Azure OpenAI. By default, evaluations run against all providers, but you can target specific ones:\n\n```bash\n# Run with all providers (default)\nmake evals\n\n# Run with only Anthropic\nLLM_PROVIDER=anthropic make evals\n\n# Run with OpenAI and Azure\nLLM_PROVIDER=openai,azure make evals\n\n# Use a specific model\nANTHROPIC_MODEL=claude-3-opus-20240229 make evals\n```\n\nSee `cmd/evalviewer/README.md` for complete documentation on environment variables and configuration options.\n\n\n## License\n\nThis repository is licensed under [Apache-2](./LICENSE), except for the [server/enterprise](server/enterprise) directory which is licensed under the [Mattermost Source Available License](LICENSE.enterprise). See [Mattermost Source Available License](https://docs.mattermost.com/overview/faq.html#mattermost-source-available-license) to learn more.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost%2Fmattermost-plugin-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattermost%2Fmattermost-plugin-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost%2Fmattermost-plugin-agents/lists"}