soulshack

 //  ____                    _   ____    _                      _
// / ___|    ___    _   _  | | / ___|  | |__     __ _    ___  | | __
// ___    / _   | | | | | | ___   | '_    / _` |  / __| | |/ /
//  ___) | | (_) | | |_| | | |  ___) | | | | | | (_| | | (__  |   <
// |____/   ___/   __,_| |_| |____/  |_| |_|  __,_|  ___| |_|_
//  .  .  .  because  real  people  are  overrated

soulshack は、openai API エンドポイントを利用して人間のような応答を生成する IRC チャット ボットです。

特徴

• IRCサーバーに接続し、指定されたチャネルに参加します
• openai API と ollam などの互換性のあるエンドポイントを利用します
• コマンドを使用してボット設定を動的に構成できます。
• IRC サーバーの ssl および SASL 認証をサポート
• ツール呼び出し、サンプルツール、チャネル管理ツール

建物

go build . 

 docker build . -t soulshack:dev

使用法

soulshack --nick chatbot --server irc.freenode.net --port 6697 --channel ' #soulshack ' --ssl --apikey **************** 

構成

soulshack は、コマンド ライン フラグ、環境変数、または設定ファイルを使用して設定できます。

フラグ

 Usage:
  soulshack --channel <channel> [--nick <nickname>] [--server <server>] [--port <port>] [--tls] [--apikey <key>] [flags]

Examples:
soulshack --nick chatbot --server irc.freenode.net --port 6697 --channel '#soulshack' --tls --apikey ****************

Flags:
  -a, --addressed                  require bot be addressed by nick for response (default true)
  -A, --admins strings             comma-separated list of allowed hostmasks (e.g. alex!~alex@localhost, josh!~josh@localhost).
  -t, --apitimeout duration        timeout for each completion request (default 5m0s)
  -c, --channel string             irc channel to join
  -C, --chunkdelay duration        after this delay, bot will look to split the incoming buffer on sentence boundaries (default 15s)
  -m, --chunkmax int               maximum number of characters to send as a single message (default 350)
  -b, --config string              use the named configuration file
      --greeting string            prompt to be used when the bot joins the channel (default "hello.")
  -h, --help                       help for soulshack
      --maxtokens int              maximum number of tokens to generate (default 512)
      --model string               model to be used for responses (default "gpt-4o")
  -n, --nick string                bot's nickname on the irc server (default "soulshack")
      --apikey string           openai api key
      --apiurl string           alternative base url to use instead of openai
  -p, --port int                   irc server port (default 6667)
      --prompt string              initial system prompt (default "you are a helpful chatbot. do not use caps. do not use emoji.")
      --saslnick string            nick used for SASL
      --saslpass string            password for SASL plain
  -s, --server string              irc server address (default "localhost")
  -S, --sessionduration duration   duration for the chat session; message context will be cleared after this time (default 3m0s)
  -H, --sessionhistory int         maximum number of lines of context to keep per session (default 50)
      --temperature float32        temperature for the completion (default 0.7)
  -e, --tls                        enable TLS for the IRC connection
      --tlsinsecure                skip TLS certificate verification
      --tools                      enable tool use (default false)
      --toolsdir                   directory to load tools from (default "examples/tools")
      --top_p float32              top P value for the completion (default 1)
  -v, --verbose                    enable verbose logging of sessions and configuration
      --version                    version for soulshack

環境変数

すべてのフラグは、接頭辞soulshack_が付いた環境変数を介して設定することもできます。たとえば、 --serverフラグの場合はsoulshack_server 。

設定ファイル

設定ファイルは yaml 形式を使用します。 --configフラグを使用してロードできます。構成ファイルには、フラグを介して設定できる任意の設定を含めることができます。

構成を追加する

新しい構成ファイルの作成を使用するには、次の手順に従います。

1. 希望の名前で新しい yml ファイルを作成します (例: marvin.yml )。
2. 必要な設定を yml ファイルに追加します。例えば：

 nick : marvin
greeting : " explain the size of your brain compared to common household objects. "
prompt : " you are marvin the paranoid android. respond with a short text message: "
channel : " #marvinshouse "
server : localhost 

soulshack --config /path/to/marvin.yml 

コマンド

• /set : 構成パラメータを設定します (例: /set nick newnick )
• /get : 構成パラメータの現在の値を取得します (例: /get nick )
• /leave : ボットをチャンネルから離れて終了させます。
• /help : 使用可能なコマンドのヘルプを表示します。

ツール

実行可能ファイルまたはスクリプトをtooldirの場所に置きます。登録するには、次のコマンドに応答する必要があります。

• --schema: ツールの使用法を記述する JSON スキーマを出力します。
• --execute $json: スキーマに一致する JSON で呼び出されます

llm があなたの人生を台無しにする何かを実行 JSON に挿入できないことを確認してください。ボットやそれを使用する人々を信頼できないからです。

正直に言うと、これはシェルスクリプトで行うべきではありません。これは一種の地雷原です。これがシェルスクリプトです

 set -e

# Check if --schema argument is provided
if [[ " $1 " == " --schema " ]] ; then
  # Output a JSON schema to describe the tool
  # shellcheck disable=SC2016
  cat << EOF
  {
  "name": "get_current_date_with_format",
  "description": "provides the current time and date in the specified unix date command format",
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "description": "The format for the date. use unix date command format (e.g., +%Y-%m-%d %H:%M:%S). always include the leading + sign."
    }
  },
  "required": ["format"],
  "additionalProperties": false
  }
EOF
  exit 0
fi



if [[ " $1 " == " --execute " ]] ; then
  # Ensure jq is available
  if ! command -v jq & > /dev/null ; then
    echo " Error: jq is not installed. " >&2
    exit 1
  fi

  # Extract format field from JSON
  format= $( jq -r ' .format ' <<< " $2 " )

  # Sanitize the format string
  if [[ " $format " =~ [^a-zA-Z0-9%+:/  - ] ]] ; then
    echo " Error: Invalid characters in format string. " >&2
    exit 1
  fi

  # Use -- to prevent option parsing
  date_output= $( date -- " $format " )
  echo " $date_output "
  exit 0
fi


# if no arguments, show usage
# shellcheck disable=SC2140
echo " Usage: currentdate.sh [--schema | --execute '{ " format " : " +%Y-%m-%d %H:%M:%S " }'] " 

私がよく思い出す古い友人、dayv、sp0t に敬意を表して名付けました。