agentirc

An AI-powered IRC agent built on a minimal async IRC bot framework. Supports multiple LLM providers (OpenAI, xAI, LM Studio) with per-user conversation history, tool use, and encrypted persistence.

Table of Contents

Quick Start

git clone <repo-url>
cd agentirc
cp .env.example .env
# Edit .env with your IRC server, nick, and at least one API provider
pip install .
agentirc

Or with Docker:

cp .env.example .env
# Edit .env
docker compose up -d

Requirements: Python 3.10+, httpx, and optionally cryptography for encrypted history persistence.

CLI Options

agentirc [options]
Flag Description
--env-file PATH Path to .env file (default: .env)
--debug Enable debug logging
--host HOST IRC server hostname (overrides IRC_HOST)
--port PORT IRC server port (overrides IRC_PORT)
--nick NICK Bot nickname (overrides IRC_NICK)
--channels CHANS Comma-separated channels (overrides IRC_CHANNELS)
--tls Connect with TLS (overrides IRC_USE_TLS)
--model MODEL Default model (overrides DEFAULT_MODEL)
--init Write a starter .env to the current directory and exit
--generate-key Generate a Fernet encryption key and exit

CLI flags override their corresponding environment variables.

Commands

User Commands

Command Aliases Description
!ai <message> !chat, !ask Talk to the AI
!persona <text> Set a persona and reintroduce
!custom <prompt> Set a custom system prompt
!reset Reset conversation to defaults
!stock Reset conversation with no system prompt
!mymodel [name] Show or set your model
!location <place> Set your location for contextual answers
!x <nick> <message> Talk as another user

Admin Commands

Command Description
!model [name|reset] Show/set global default model
!tools [on|off|toggle|status] Enable/disable tool use
!verbose [on|off|toggle] Toggle verbose mode
!clear Clear all conversation state
!country [on|off|status] Toggle search country filtering
!join <#channel> Join a channel
!part [#channel] [reason] Leave a channel

Built-in IRC commands (!ping, !time, !help) are also available.

Documentation

License

MIT

Project links

Data verified by PyPI on Aug 7, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for h1ddenpr0cess20 from gravatar.com h1ddenpr0cess20

GitHub Statistics

Data verified by PyPI on Aug 7, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

crypto test

Tags

agent ai bot chatbot grok irc llm openai xai

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentirc-1.4.0.tar.gz (47.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentirc-1.4.0-py3-none-any.whl (28.6 kB view details)

Uploaded Python 3

File details

Details for the file agentirc-1.4.0.tar.gz.

File metadata

  • Download URL: agentirc-1.4.0.tar.gz
  • Upload date:
  • Size: 47.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentirc-1.4.0.tar.gz
Algorithm Hash digest
SHA256 4da2a3d2381f869d5ebc2a244c51b67a1243bb49256bb38fc009c4e8ab973b5b
MD5 812481deb61371526c0ce0138fd40db1
BLAKE2b-256 ba6e5f4d9baeb48b8511c6d9a2d5719d004dea76ab6c9daea6e2246cce3fce04

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentirc-1.4.0.tar.gz:

Publisher: pypi-publish.yml on h1ddenpr0cess20/agentirc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentirc-1.4.0-py3-none-any.whl.

File metadata

  • Download URL: agentirc-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 28.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentirc-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 818f1070027a56c8166ece3165be9e90f33e83a5efedb417bc0f41a823af7cee
MD5 06362fb25e3aaa13afb49fdb818ef56d
BLAKE2b-256 2ec0aa089871e6e08ca65839ca8a41bd62d8439c83c5c15589dfd66d2fae9bca

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentirc-1.4.0-py3-none-any.whl:

Publisher: pypi-publish.yml on h1ddenpr0cess20/agentirc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.4.0 This release

2 files

1.3.0

2 files

1.1.1

2 files

1.1.0

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page