# soulshack

> soulshack, an irc chatbot. openai/ollama/gemini/anthropic apis. basic shell tools and mcp server support.

- **URL**: https://www.freshcrate.ai/projects/soulshack
- **Author**: pkdindustries
- **Category**: MCP Servers
- **Latest version**: `v0.93` (2025-12-13)
- **License**: GPL-3.0
- **Source**: https://github.com/pkdindustries/soulshack
- **Language**: Go
- **GitHub**: 29 stars, 5 forks
- **Registry**: github (`pkdindustries/soulshack`)
- **Tags**: `agentic`, `ai`, `anthropic`, `blah`, `blahblah`, `chatbot`, `gemini`, `go`, `irc`

## Description

soulshack, an irc chatbot. openai/ollama/gemini/anthropic apis. basic shell tools and mcp server support.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.93` | 2025-12-13 | Low | new commands      /stats - display comprehensive session statistics:         token usage (input/output)         context capacity percentage         message counts by role (user, assistant, tool)         participant count         session TTL and expiry countdown     /tools load and /tools rm - aliases for add and remove  new flags      --maxcontext - set maximum context window tokens (enables capacity warnings)     --channelkey - join password-protected channels     --stream - toggl |
| `v0.92` | 2025-12-03 | Low | ## docs -  cleaned up readme.md -  added docs/architecture.md -  added docs/contributing.md -  added architecture diagram   ## internal  -  abstract tooling from girc implementation  ## bugfixes -  fixed openai endpoint url |
| `v0.91` | 2025-12-02 | Low | # v0.91  uses latest [polly](https://github.com/alexschlessinger/pollytool) for tool use improvements including parallel toolcalls.   new flag: - `urlwatcher` - respond to urls without being addressed (for use with eg a browser tool)  new commands: - `/admins` - list current admins  - `/admins add <hostmask>` - add admin - `/admins remove <hostmask>` - remove admin - `/tools` - list loaded tools - `/tools add <path>` - load tool  - `/tools remove <pattern>` - unload by name or wildc |
| `v0.89` | 2025-08-19 | Low | ## What's Changed  refactors to use [polly](https://github.com/alexschlessinger/pollytool) package for llm stuff we get real streaming in return and net -1800 loc for the bot  new: --thinking to enable reasoning --showthinkingactions to announce delays due to reasoning after 5s --showtoolactions to show toolcalls as an irc action  breaking: --mcptools -> --mcptool --shelltools -> --shelltool --irctools -> --irctool  **Full Changelog**: https://github.com/pkdindustries/soulshack/co |
| `v0.87` | 2025-08-10 | Low | Resolved an issue where multiple tool calls in a single assistant response would cause "tool_call_id did not have response messages" errors. |
| `v0.86` | 2025-08-10 | Low | New Features    MCP (Model Context Protocol) Server Support    - Added full MCP server integration - Soulshack can now connect to and use MCP servers as tool providers   - Dynamic tool loading - Automatically discovers and loads tools from MCP servers at startup   - Configuration support - New mcpservers configuration block in YAML config files   - Command-line support - Added --mcpservers flag to specify MCP servers directly    Bug Fixes    - Fixed array property handling for all L |
| `v0.82` | 2025-08-08 | Low | Multi-provider LLM support    - Support for Anthropic Claude, Google Gemini, and Ollama alongside OpenAI   - Models now specified with provider prefix: provider/model     - openai/gpt-4o     - anthropic/claude-3-7-sonnet     - gemini/gemini-2.5-flash     - ollama/llama3.2    What's New    - Anthropic Claude support with tool calling   - Google Gemini integration with tools   - Ollama for local model hosting   - Refactored tool system with provider-specific converters   - Increas |
| `v0.74` | 2024-10-21 | Low | ### features tool use now supported on ollama served models (see [ollamabot.yml](examples/ollamabot.yml)) added [documents.py](examples/tools/documents.py), an example tool for fetching documents or news articles  ### config  *--openaikey* renamed *--apikey* *--openapiurl*  renamed *--apiurl* *--stream <bool>*  introduced to toggle api streaming support *--admins* now uses hostmasks  ### streamlined shell tool api the --name and --description command interfaces have been removed from |
| `v0.72` | 2024-10-13 | Low | Release v0.7 Highlights:  Cleaner, more streamlined configuration options Added support for OpenAI tool use (function calling) Includes sample tools for weather, unix system info, datetime and more Include built in IRC tools for /op, /topic, and /kick Various bug fixes and stability enhancements  Added configuration options  --top_p: Top P value for the completion (default: 1) --tools: Enable tool use (default: false) --toolsdir: Directory to load tools from (default: "examples/tools |
| `v0.42.17` | 2024-08-08 | Low | ## What's Changed * added SASL plain auth by @terminaldweller in https://github.com/pkdindustries/soulshack/pull/10 * Have dependabot update github actions by @tvalenta in https://github.com/pkdindustries/soulshack/pull/12 * The one run through the linter by @tvalenta in https://github.com/pkdindustries/soulshack/pull/15 * The one with gh cli for releases by @tvalenta in https://github.com/pkdindustries/soulshack/pull/28 * Allow alternate OpenAI API URL with --openaiurl by @lstarnes1024 in |

## Citation

- HTML: https://www.freshcrate.ai/projects/soulshack
- Markdown: https://www.freshcrate.ai/projects/soulshack.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/soulshack/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._