{"id":29857112,"url":"https://github.com/h1ddenpr0cess20/ollamarama-irc","last_synced_at":"2025-07-30T00:37:54.975Z","repository":{"id":212913975,"uuid":"732589813","full_name":"h1ddenpr0cess20/ollamarama-irc","owner":"h1ddenpr0cess20","description":"AI chatbot for IRC with infinite personalties, using ollama","archived":false,"fork":false,"pushed_at":"2025-07-11T23:40:14.000Z","size":71,"stargazers_count":8,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-19T21:21:32.905Z","etag":null,"topics":["ai","chatbot","irc","irc-bot","llm","ollama"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/h1ddenpr0cess20.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,"zenodo":null}},"created_at":"2023-12-17T07:20:15.000Z","updated_at":"2025-07-11T23:40:17.000Z","dependencies_parsed_at":"2023-12-23T22:19:35.719Z","dependency_job_id":"5edc29b1-c791-4580-8f16-afc20c2c81a1","html_url":"https://github.com/h1ddenpr0cess20/ollamarama-irc","commit_stats":{"total_commits":33,"total_committers":1,"mean_commits":33.0,"dds":0.0,"last_synced_commit":"397fa00252f6af5834b2d1122a523d612165c1a7"},"previous_names":["h1ddenpr0cess20/ollamarama-irc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/h1ddenpr0cess20/ollamarama-irc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h1ddenpr0cess20%2Follamarama-irc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h1ddenpr0cess20%2Follamarama-irc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h1ddenpr0cess20%2Follamarama-irc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h1ddenpr0cess20%2Follamarama-irc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/h1ddenpr0cess20","download_url":"https://codeload.github.com/h1ddenpr0cess20/ollamarama-irc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h1ddenpr0cess20%2Follamarama-irc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266189677,"owners_count":23890065,"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","chatbot","irc","irc-bot","llm","ollama"],"created_at":"2025-07-30T00:37:54.451Z","updated_at":"2025-07-30T00:37:54.965Z","avatar_url":"https://github.com/h1ddenpr0cess20.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ollamarama-irc\n\n[![License](https://img.shields.io/badge/License-AGPL--3.0-green.svg)](LICENSE)\n[![Ollama](https://img.shields.io/badge/Powered%20by-Ollama-orange.svg)](https://ollama.com/)\n[![IRC](https://img.shields.io/badge/Protocol-IRC-purple.svg)](https://en.wikipedia.org/wiki/Internet_Relay_Chat)\n\nOllamarama is an AI chatbot for IRC that uses local LLMs with Ollama. It can roleplay as almost anything you can think of with customizable personalities, individual user chat histories, and collaborative features.\n\n## ✨ Features\n\n- 🎭 **Roleplay as any character or personality** - Set any default personality that can be changed at any time\n- 👥 **Individual chat histories** - Each user maintains their own separate conversation with their chosen personality\n- 🤝 **Collaborative mode** - Users can interact with each other's chat histories for collaboration\n- 🔄 **Real-time personality switching** - Change personalities on the fly during conversations\n\n## 🌐 Other Versions\n\n- **Matrix**: [ollamarama-matrix](https://github.com/h1ddenpr0cess20/ollamarama-matrix/)\n- **Terminal**: [ollamarama](https://github.com/h1ddenpr0cess20/ollamarama)\n\n\n## 🚀 Setup\n\n### Prerequisites\nInstall and familiarize yourself with [Ollama](https://ollama.com/). Make sure you can run local LLMs successfully.\n\n**Linux installation:**\n```bash\ncurl https://ollama.com/install.sh | sh\n```\n\n**Windows installation:**  \nDownload the app from the [Ollama website](https://ollama.com/).\n\n### Model Setup\n1. Browse and [download models](https://ollama.com/library) that work best for your use case\n2. Add your chosen models to the `config.json` file\n3. Install models using: `ollama pull modelname`\n\n### Configuration\nFill in the required values in `config.json`:\n- `channel` - IRC channel to join\n- `nickname` - Bot's IRC nickname  \n- `server` - IRC server address\n- `password` - IRC password (optional, but required for some channels)\n\n### Environment Setup\nCreate a virtual environment and install dependencies:\n\n**Linux/macOS:**\n```bash\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\n```\n\n**Windows:**\n```cmd\npython3 -m venv venv\nvenv\\Scripts\\activate\npip install -r requirements.txt\n```\n\n## 💬 Usage\n\n### Starting the Bot\n```bash\npython3 ollamarama.py\n```\n\n### Commands\n\n| Command | Description |\n|---------|-------------|\n| `.ai message` or `botname: message` | Basic chat with the AI |\n| `.x user message` | Talk to another user's chat history |\n| `.persona personality` | Change personality (character, type, object, idea) |\n| `.custom prompt` | Set a custom system prompt instead of roleplay |\n| `.reset` | Reset to preset personality |\n| `.stock` | Remove personality and use standard model settings |\n| `.help` | Display the help menu |\n| `.model` | Show current model and available models *(admin only)* |\n| `.model name` | Set a specific model *(admin only)* |\n\n### Examples\n```\n.ai Hello, how are you today?\nbotname: What's the weather like?\n.persona Sherlock Holmes\n.x alice What do you think about this mystery?\n.custom You are a helpful programming assistant\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh1ddenpr0cess20%2Follamarama-irc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh1ddenpr0cess20%2Follamarama-irc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh1ddenpr0cess20%2Follamarama-irc/lists"}