soulshack
by pkdindustries
Overview
An advanced IRC chatbot powered by LLMs, designed to bridge traditional chat with modern AI capabilities and a unified tool system.
Installation
docker run -v $(pwd)/examples/chatbot.yml:/config.yml soulshack:dev --config /config.ymlEnvironment Variables
- SOULSHACK_OPENAIKEY
- SOULSHACK_ANTHROPICKEY
- SOULSHACK_GEMINIKEY
- SOULSHACK_OLLAMAURL
- SOULSHACK_OLLAMAKEY
- SOULSHACK_CONFIG
- SOULSHACK_NICK
- SOULSHACK_SERVER
- SOULSHACK_PORT
- SOULSHACK_CHANNEL
- SOULSHACK_CHANNELKEY
- SOULSHACK_TLS
- SOULSHACK_TLSINSECURE
- SOULSHACK_SASLNICK
- SOULSHACK_SASLPASS
- SOULSHACK_ADMINS
- SOULSHACK_VERBOSE
- SOULSHACK_MAXTOKENS
- SOULSHACK_MODEL
- SOULSHACK_APITIMEOUT
- SOULSHACK_TEMPERATURE
- SOULSHACK_TOP_P
- SOULSHACK_THINKINGEFFORT
- SOULSHACK_STREAM
- SOULSHACK_TOOL
- SOULSHACK_SHOWTHINKINGACTION
- SOULSHACK_SHOWTOOLACTIONS
- SOULSHACK_URLWATCHER
- SOULSHACK_URLWATCHERTEMPLATE
- SOULSHACK_ADDRESSED
- SOULSHACK_SESSIONDURATION
- SOULSHACK_MAXCONTEXT
- SOULSHACK_CHUNKMAX
- SOULSHACK_GREETING
- SOULSHACK_PROMPT
Security Notes
CRITICAL: By default, if the 'admins' list is empty, *any* user on IRC is considered an admin. This grants them full control over bot settings, including adding/removing tools (which can execute shell commands) and modifying API keys at runtime. Running this bot without explicitly configuring an 'admins' hostmask is a severe security risk. Additionally, the 'examples/tools/news.py' script uses 'verify=False' for HTTPS requests, which is vulnerable to Man-in-the-Middle attacks, and has a hardcoded empty API key, although this tool is optional.
Similar Servers
Docker_MCPGUIApp
This repository provides a starter template for building full-stack AI assistants that integrate with real-world tools using Docker MCP Gateway and a Large Language Model.
remembrances-mcp
Provides long-term memory, knowledge base, and semantic code indexing capabilities for AI agents.
fastchat-mcp
A Python client for integrating Language Models with Model Context Protocol (MCP) servers, allowing natural language interaction with external tools, resources, and prompts.
mu-mcp
Enable chat with AI models via OpenRouter, facilitating multi-model conversations and persistent state for AI agents.