{"id":18580508,"url":"https://github.com/oiramnet/ai-irc-bot","last_synced_at":"2026-01-27T18:40:41.108Z","repository":{"id":261421785,"uuid":"884232992","full_name":"oiramNet/AI-IRC-Bot","owner":"oiramNet","description":"AI-based IRC Bot","archived":false,"fork":false,"pushed_at":"2025-02-06T10:59:57.000Z","size":155,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T17:06:37.634Z","etag":null,"topics":["ai","anthropic","bot","chatgpt","claude","irc","openai"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oiramNet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-06T11:43:32.000Z","updated_at":"2025-02-06T11:00:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"ce677187-3387-4762-8765-c4fc53cd80f7","html_url":"https://github.com/oiramNet/AI-IRC-Bot","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":"0.052631578947368474","last_synced_commit":"ee02c79be26419cd7868f29312020f3b5fae040d"},"previous_names":["oiramnet/ai-irc-bot"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oiramNet%2FAI-IRC-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oiramNet%2FAI-IRC-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oiramNet%2FAI-IRC-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oiramNet%2FAI-IRC-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oiramNet","download_url":"https://codeload.github.com/oiramNet/AI-IRC-Bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251722942,"owners_count":21633049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anthropic","bot","chatgpt","claude","irc","openai"],"created_at":"2024-11-07T00:00:24.478Z","updated_at":"2026-01-27T18:40:41.103Z","avatar_url":"https://github.com/oiramNet.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003c!-- Title: --\u003e\n  \u003ch1\u003e\u003ca href=\"https://github.com/oiramNet/AI-IRC-Bot/\"\u003eAI IRC Bot\u003c/h1\u003e\n\u003c!-- Labels: --\u003e\n  \u003c!-- First row: --\u003e\n    \u003cimg src=\"https://img.shields.io/github/repo-size/oiramNet/AI-IRC-Bot?label=Repo%20size\u0026style=flat-square\" height=\"20\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/oiramNet/AI-IRC-Bot/total?label=Downloads\u0026style=flat-square\" height=\"20\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/oiramNet/AI-IRC-Bot?label=License\u0026style=flat-square\" height=\"20\"\u003e\n\t\t\u003cbr\u003e\n  \u003c!-- Second row: --\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/oiramNet/AI-IRC-Bot/enhancement?label=Enhancements\u0026style=flat-square\" height=\"20\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/oiramNet/AI-IRC-Bot/bug?label=Bugs\u0026style=flat-square\" height=\"20\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/discussions/oiramNet/AI-IRC-Bot?label=Discussions\u0026style=flat-square\" height=\"20\"\u003e\n\u003c!-- Short description: --\u003e\n\u003c/div\u003e\n\n\n__AI IRC Bot__ is a simple IRC bot written in Python. It was initially forked from the [knrd1/chatgpt](https://github.com/knrd1/chatgpt) into [oiramNet/ChatGPT-IRC-Bot](https://github.com/oiramNet/ChatGPT-IRC-Bot) but turned into its own project to support other __AI__ back-ends. It connects to the selected __AI__ endpoints to answer questions or generate images and uses official bindings from __AI__ to interact with it using the __API__ through the HTTP/HTTPS requests. You can find more details about supported __APIs__ below:\n\n* ChatGPT (OpenAI): https://platform.openai.com/docs/api-reference\n* Claude (Anthropic): https://docs.anthropic.com/en/api/getting-started\n\n## Prerequisites\n1. Create an account and obtain your __API KEY__\n   * ChatGPT (OpenAI): https://platform.openai.com/account/api-keys\n   * Claude (Anthropic): https://console.anthropic.com/settings/keys\n2. Install Python3 and the official bindings (__pyshorteners__; __pytz__; __openai__; __anthropic__)\n   * Debian/Ubuntu\n     ```\n     apt install python3 python3-pip\n     pip3 install pyshorteners pytz openai anthropic\n     ```\n   * RedHat/CentOS\n     ```\n     yum install python3 python3-pip\n     pip3 install pyshorteners pytz openai anthropic\n     ```\n   * FreeBSD\n     ```\n     pkg install python311 py311-pip\n     pip install pyshorteners pytz openai anthropic\n     ```\n\n## Installation\nClone the package using the command below. It will copy all files into the __AI-IRC-Bot__ directory, which you can later rename.\n```\ngit clone https://github.com/oiramNet/AI-IRC-Bot\n```\n\n## Configuration\n__AI IRC Bot__ uses a plain-text file for configuration. The package includes an example configuration file (__AIbot.conf.sample__), which is set to connect to __IRCnet__. You can copy and modify it to suit your preferences.\n\n```\ncd AI-IRC-Bot\ncp AIbot.conf.sample SampleBot.conf\n```\n\u003e Some of the settings apply only to the specific __AI API__ or models. Be sure to check the sample configuration file for more details.\n\n### Supported models\n__AI IRC Bot__ can use any of the below models.\n* ChatGPT (OpenAI): https://platform.openai.com/docs/models\n  * Chat Completion models\n    \u003e o3-mini, gpt-4o, __gpt-4o-mini__, gpt-4, gpt-4-turbo, gpt-4-turbo-preview, gpt-3.5-turbo\n  * Image creation models\n    \u003e dall-e-2, dall-e-3\n* Claude (Anthropic): https://docs.anthropic.com/en/docs/about-claude/models\n  * Chat Completion models\n    \u003e claude-3-5-sonnet-latest, __claude-3-5-haiku-latest__\n\nWe suggest starting experimenting with __gpt-4o-mini__ for the ChatGPT (OpenAI) or __claude-3-5-haiku-latest__ for Claude (Anthropic).\n\n## Running bot\nTo start the bot, run the command below. Make sure to replace __CONFIG__ with the name of your configuration file.\n* Debian/Ubuntu/RedHat/CentOS\n  ```\n  python3 AIbot.py CONFIG\n  ```\n* FreeBSD\n  ```\n  python3.11 AIbot.py CONFIG\n  ```\n\n## Interaction\n__AI IRC Bot__ is designed to process messages on standard channels (__#CHANNEL__) and will interact (respond) only to messages directed to it using its nickname (__BOTNAME: MESSAGE__).\n```console\n12:34:12 \u003c user\u003e SampleBot: how are you?\n12:34:13 \u003c SampleBot\u003e I'm doing well, thank you for asking! How are you today? Is there anything specific I can help you with?\n12:56:21 \u003c user\u003e SampleBot: do you like IRC?\n12:56:22 \u003c SampleBot\u003e I'm an AI, so I don't personally \"like\" or \"dislike\" things in the way humans do. However, I'm familiar with IRC (Internet Relay Chat) as a communication protocol. It's an older form of real-time internet chat that was very popular before modern messaging platforms. Would you like to discuss IRC or chat protocols?\n```\n\nIf you set the model to __dall-e-2__ or __dall-e-3__ (ChatGPT/Image creation), the __AI IRC Bot__ will return a shortened URL to the generated image.\n```console\n13:14:05 \u003c user\u003e SampleBot: red apples on the table\n13:14:35 \u003c SampleBot\u003e https://tinyurl.com/1a2b3c4d\n```\n\n## Bugs, Enhancements, etc.\nFeel free to contact us through the __GitHub__.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foiramnet%2Fai-irc-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foiramnet%2Fai-irc-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foiramnet%2Fai-irc-bot/lists"}