pkdindustries/soulshack

Soulshack은 LLM 기반의 고급 IRC 챗봇으로, 전통적인 채팅과 현대적인 AI 기능을 연결하도록 설계되었습니다.

Multi-Provider Support: OpenAI, Anthropic, Google Gemini, Ollama 와 호환됩니다.
Unified Tool System: 쉘 스크립트, MCP 서버, 네이티브 IRC 도구를 지원합니다.
Secure: 완전한 SSL/TLS 및 SASL 인증을 지원합니다.
Session Management: 설정 가능한 히스토리, 컨텍스트 윈도우, 세션 TTL 을 제공합니다.
Streaming: IRC 에 적합한 청킹으로 실시간 응답을 제공합니다.
Passive Mode: 선택적인 URL 감시 및 분석 기능을 제공합니다.
Runtime Configuration: IRC 명령어를 통해 설정을 관리할 수 있습니다.

docker build . -t soulshack:dev

Prerequisites: Go 1.23+

• Clone and Build: git clone https://github.com/pkdindustries/soulshack.git cd soulshack go build -o soulshack cmd/soulshack/main.go

• Run:
  Local Binary: ./soulshack --config examples/chatbot.yml

  Docker: # Mount config file to container docker run -v $(pwd)/examples/chatbot.yml:/config.yml soulshack:dev \ --config /config.yml

  Local Binary: ./soulshack \ --nick soulshack \ --server irc.example.com \ --port 6697 \ --tls \ --channel '#soulshack' \ --saslnick mybot \ --saslpass mypassword \ --admins "admin!*@*" \ --model openai/gpt-5.1 \ --openaikey "sk-..." \ --maxtokens 4096 \ --temperature 1 \ --apitimeout 5m \ --tool "examples/tools/datetime.sh" \ --tool "irc__op" \ --thinkingeffort off \ --urlwatcher \ --verbose

  Docker: docker run soulshack:dev \ --nick soulshack \ --server irc.example.com \ --port 6697 \ --tls \ --channel '#soulshack' \ --saslnick mybot \ --saslpass mypassword \ --admins "admin!*@*" \ --model openai/gpt-5.1 \ --openaikey "sk-..." \ --maxtokens 4096 \ --temperature 1 \ --apitimeout 5m \ --thinkingeffort off \ --urlwatcher \ --verbose # Note: Local file tools/scripts require volume mounts to work in Docker

  Local Binary: ./soulshack \ --server irc.example.com \ --channel '#soulshack' \ --model ollama/qwen3:30b \ --ollamaurl "http://localhost:11434"

  Docker: # Use --network host to access Ollama on localhost docker run --network host soulshack:dev \ --server irc.example.com \ --channel '#soulshack' \ --model ollama/qwen3:30b \ --ollamaurl "http://localhost:11434"

  Local Binary: ./soulshack \ --server irc.example.com \ --channel '#soulshack' \ --model anthropic/claude-opus-4.5 \ --anthropickey "sk-ant-..."

  Docker: docker run soulshack:dev \ --server irc.example.com \ --channel '#soulshack' \ --model anthropic/claude-opus-4.5 \ --anthropickey "sk-ant-..."

Flag	Default	Description
-n, --nick	soulshack	Bot nickname
-s, --server	localhost	IRC server address
-p, --port	6667	IRC server port
-c, --channel	Channel to join
-e, --tls	false	Enable TLS
--tlsinsecure	false	Skip TLS cert verification
--saslnick	SASL username
--saslpass	SASL password
-b, --config	Path to YAML config file
-A, --admins	Comma-separated admin hostmasks
-V, --verbose	f