hunter3

hunter3 is a versatile personal AI assistant designed to connect various messaging channels with large language model (LLM) providers and external tools. Utilizing a configurable WebSocket-based gateway, it efficiently manages conversations and sessions, allowing for real-time interaction and seamless integration.

Key Features

• Self-Modifying Capabilities: hunter3 can dynamically modify and rebuild itself based on user prompts, automatically reconnecting to the desired IRC server. If necessary, users can access the terminal to fix issues using the CLI tools available like Claude.
• Flexible Communication Options: Primarily built for IRC, hunter3 can be configured to work with other communication methods via bitlbee, providing further flexibility to users seeking diverse messaging solutions.
• Robust Architecture:

 Messaging Channels          Gateway               LLM Providers
┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│              │        │   Router     │        │  Claude CLI  │
│              │        │      │       │        ├──────────────┤
│     IRC      │◄──────►│   Agent      │◄──────►│  Gemini CLI  │
│              │        │      │       │        ├──────────────┤
│              │        │   Sessions   │        │  Ollama      │
└──────────────┘        └──────┬───────┘        └──────────────┘
                               │
                 ┌─────────────┼─────────────┐
                 │             │             │
          ┌──────┴──────┐ ┌───┴────┐ ┌──────┴──────┐
          │    MCP      │ │ SQLite │ │  Plugins    │
          │  Servers    │ │   DB   │ │             │
          └─────────────┘ └────────┘ └─────────────┘

Messages are routed through the gateway to an agent that queries the LLM provider, returning responses directly to users.

LLM Integration

hunter3 leverages existing CLI tools for LLM integration, avoiding direct API implementations. This approach effectively reuses authentication, caching, and rate limiting mechanisms of the CLI tools.

Plugin Support

hunter3 features a comprehensive plugin system enabling users to extend its functionality. Plugins can interact with key events throughout various stages such as message handling or session lifecycle events.

Advanced Streaming Features

The implementation supports streaming capabilities, allowing real-time output during execution with incremental feedback. This feature enriches the user experience by providing timely responses and updates.

Configuration and Management

Configuration files are stored in standard locations, making it easy to manage settings through a dedicated YAML configuration file:

gateway:
  port: 18789
  bind: loopback          # loopback | lan | custom | tailnet
  auth:
    mode: token           # token | password

channels:
  irc:
    server: irc.example.com
    port: 6697
    nick: mybot
    channels:
      - "#general"
    useTLS: true
    sasl: true

Requirements

• Go 1.24+
• At least one LLM CLI tool (e.g. claude, gemini, ollama, where only Claude is currently supported).

Summary

hunter3 uniquely combines AI assistance with flexible connectivity across multiple platforms, featuring real-time communication, self-modifying capabilities, a robust plugin architecture, and advanced interaction options. This makes it a powerful tool for those looking to enhance their digital communication environment.