{"id":30674331,"url":"https://github.com/lifailon/openrouter-bot","last_synced_at":"2025-09-01T07:07:41.021Z","repository":{"id":302398089,"uuid":"1012154922","full_name":"Lifailon/openrouter-bot","owner":"Lifailon","description":"This project allows to launch your Telegram bot in a few minutes to communicate with free or paid AI models via OpenRouter.","archived":false,"fork":false,"pushed_at":"2025-08-21T08:30:40.000Z","size":339,"stargazers_count":39,"open_issues_count":0,"forks_count":8,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-28T16:59:33.442Z","etag":null,"topics":["ai","ai-integration","chat-bot","go","gpt","llm","llm-inference","openrouter","telegrambot"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/lifailon/openrouter-bot","language":"Go","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/Lifailon.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":"2025-07-01T22:49:32.000Z","updated_at":"2025-08-28T16:22:14.000Z","dependencies_parsed_at":"2025-07-02T07:40:56.580Z","dependency_job_id":"1dfb42e9-7b28-45fc-8d00-d94e62ad97b0","html_url":"https://github.com/Lifailon/openrouter-bot","commit_stats":null,"previous_names":["lifailon/openrouter-bot"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Lifailon/openrouter-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lifailon%2Fopenrouter-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lifailon%2Fopenrouter-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lifailon%2Fopenrouter-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lifailon%2Fopenrouter-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lifailon","download_url":"https://codeload.github.com/Lifailon/openrouter-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lifailon%2Fopenrouter-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273086448,"owners_count":25043339,"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","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","ai-integration","chat-bot","go","gpt","llm","llm-inference","openrouter","telegrambot"],"created_at":"2025-09-01T07:07:39.988Z","updated_at":"2025-09-01T07:07:41.010Z","avatar_url":"https://github.com/Lifailon.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n    \u003cimg src=\"img/logo.png\" width=\"220\" /\u003e\n    \u003cdiv\u003e\n    OpenRouter\n    \u003cbr\u003e\n    Bot\n    \u003c/div\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n    \u003cstrong\u003eEnglish (🇺🇸)\u003c/strong\u003e | \u003ca href=\"README_RU.md\"\u003eРусский (🇷🇺)\u003c/a\u003e\n\u003c/h4\u003e\n\nThis project allows you to launch your Telegram bot in a few minutes to communicate with free and paid AI models via [OpenRouter](https://openrouter.ai), or local LLMs, for example, via [LM Studio](https://lmstudio.ai).\n\n\u003e [!NOTE]\n\u003e This repository is a fork of the [openrouter-gpt-telegram-bot](https://github.com/deinfinite/openrouter-gpt-telegram-bot) project, which adds new features (such as switch current model and `Markdown` formatting in bot responses) and optimizes the container startup process.\n\n\u003cdetails\u003e\n    \u003csummary\u003eExample\u003c/summary\u003e\n    \u003cimg src=\"./img/example.png\"\u003e\n    \u003cimg src=\"./img/commands.png\"\u003e\n\u003c/details\u003e\n\n## Preparation\n\n- Register with [OpenRouter](https://openrouter.ai) and get an [API key](https://openrouter.ai/settings/keys).\n\n- Create your Telegram bot using [@BotFather](https://telegram.me/BotFather) and get its API token.\n\n- Get your telegram id using [@getmyid_bot](https://t.me/getmyid_bot).\n\n\u003e [!TIP]\n\u003e When you launch the bot, you will be able to see the IDs of other users in the log, to whom you can also grant access to the bot in the future.\n\n## Installation\n\nTo run locally on Windows or Linux system, download the pre-built binary (without dependencies) from the [releases](https://github.com/Lifailon/openrouter-bot/releases) page.\n\n### Running in Docker\n\n- Create a working directory:\n\n```bash\nmkdir openrouter-bot\ncd openrouter-bot\n```\n\n- Create `.env` file and fill in the basic parameters:\n\n```bash\n# OpenRouter api key\nAPI_KEY=\n# Free modeles: https://openrouter.ai/models?max_price=0\nMODEL=deepseek/deepseek-r1:free\n# Telegram api key\nTELEGRAM_BOT_TOKEN=\n# Your Telegram id\nADMIN_IDS=\n# List of users to access the bot, separated by commas\nALLOWED_USER_IDS=\n# Disable guest access (enabled by default)\nGUEST_BUDGET=0\n# Language used for bot responses (supported: EN/RU)\nLANG=EN\n```\n\nThe list of all available parameters is listed in the [.env.example](https://github.com/Lifailon/openrouter-bot/blob/main/.env.example) file\n\n- Run a container using the image from [Docker Hub](https://hub.docker.com/r/lifailon/openrouter-bot):\n\n```bash\ndocker run -d --name OpenRouter-Bot \\\n    -v ./.env:/openrouter-bot/.env \\\n    --restart unless-stopped \\\n    lifailon/openrouter-bot:latest\n```\n\nThe image is build for `amd64` and `arm64` (Raspberry Pi) platforms using [docker buildx](https://github.com/docker/buildx).\n\n## Build\n\n```bash\ngit clone https://github.com/Lifailon/openrouter-bot\ncd openrouter-bot\ndocker-compose up -d --build\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flifailon%2Fopenrouter-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flifailon%2Fopenrouter-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flifailon%2Fopenrouter-bot/lists"}