soulshack
by pkdindustries
Overview
An IRC chatbot powered by LLMs, designed to bridge traditional chat with modern AI capabilities, supporting multi-provider LLMs and a unified tool system.
Installation
docker run -e SOULSHACK_OPENAIKEY=sk-... soulshack:dev --channel '#soulshack'Environment Variables
- SOULSHACK_OPENAIKEY
- SOULSHACK_ANTHROPICKEY
- SOULSHACK_GEMINIKEY
- SOULSHACK_OLLAMAURL
- SOULSHACK_OLLAMAKEY
- SOULSHACK_CHANNEL
- SOULSHACK_ADMINS
Security Notes
Critical: The default configuration allows any user to execute admin commands if no admin hostmasks are explicitly configured (`CheckAdmin` returns true for an empty admin list). This allows any user to add/remove tools or change API keys. Example tools like `news.py` use `verify=False` for HTTPS requests, creating a Man-in-the-Middle vulnerability. The unified tool system allows execution of shell scripts and MCP server commands, which, while a core feature, becomes a major arbitrary code execution risk due to the lax default admin permissions. CLI flags can also expose API keys in process listings.
Similar Servers
wcgw
An MCP server that empowers AI chat applications to execute shell commands, edit code, and manage project context on a local machine for development tasks.
Local_MCP_Client
The client acts as a cross-platform web and API interface for natural language interaction with configurable MCP servers, facilitating structured tool execution and dynamic agent behavior using local LLMs.
Docker_MCPGUIApp
A conversational AI chatbot leveraging Docker's Model and Component Protocol (MCP) to integrate with LLMs and perform various tool-augmented searches (web, academic papers).
remembrances-mcp
Provides long-term memory capabilities to AI agents through key-value, vector/RAG, and graph database layers, with advanced code indexing for semantic search and navigation.