{"id":45970404,"url":"https://github.com/harsh-2002/relay","last_synced_at":"2026-03-13T09:02:17.553Z","repository":{"id":341115983,"uuid":"1168834953","full_name":"Harsh-2002/Relay","owner":"Harsh-2002","description":"Your personal AI Agent \u0026 Assistant — powered by Telegram.","archived":false,"fork":false,"pushed_at":"2026-03-12T06:10:24.000Z","size":1182,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-12T11:12:27.843Z","etag":null,"topics":["ai-agents","claude-code","coding","opencode","telegram"],"latest_commit_sha":null,"homepage":"https://harsh-2002.github.io/Relay/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Harsh-2002.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-27T21:15:19.000Z","updated_at":"2026-03-12T06:12:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Harsh-2002/Relay","commit_stats":null,"previous_names":["harsh-2002/ocbot","harsh-2002/relay"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/Harsh-2002/Relay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Harsh-2002%2FRelay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Harsh-2002%2FRelay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Harsh-2002%2FRelay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Harsh-2002%2FRelay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Harsh-2002","download_url":"https://codeload.github.com/Harsh-2002/Relay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Harsh-2002%2FRelay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30463559,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T06:34:02.089Z","status":"ssl_error","status_checked_at":"2026-03-13T06:33:49.182Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-agents","claude-code","coding","opencode","telegram"],"created_at":"2026-02-28T15:07:35.584Z","updated_at":"2026-03-13T09:02:17.545Z","avatar_url":"https://github.com/Harsh-2002.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Relay\n\n[![npm version](https://img.shields.io/npm/v/@4via6/relay)](https://www.npmjs.com/package/@4via6/relay)\n[![npm downloads](https://img.shields.io/npm/dm/@4via6/relay)](https://www.npmjs.com/package/@4via6/relay)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nYour personal AI agent — powered by Telegram. Browse the web, schedule tasks, run shell commands, and talk in your language. Powered by [OpenCode](https://github.com/opencode-ai/opencode) with 75+ AI providers including Anthropic, OpenAI, Google, DeepSeek, Mistral, and local models.\n\n## Features\n\n- **75+ AI providers** -- Anthropic, OpenAI, Google, DeepSeek, Mistral, local models, and more via OpenCode\n- **Text, voice, photo, and file input** -- send messages in any format\n- **Streaming responses** -- live-streamed with reasoning display in collapsible blockquotes\n- **Session management** -- create, switch, fork, delete, rename, and list sessions\n- **MCP tools** -- Browser, Fetch, Memory, Filesystem, GitHub, Context7, plus custom servers at runtime\n- **Scheduled tasks** -- cron jobs on a schedule (interval, daily, weekly, once) with isolated sessions\n- **Shell access** -- run commands on your machine directly from Telegram\n- **Voice transcription** -- Groq, Sarvam, OpenAI, or AssemblyAI speech-to-text\n- **Custom system prompts** -- load from `SKILL.md`, hot-reload on change\n- **File operations** -- list, read, find, search, and browse project files\n- **Dynamic model selection** -- models fetched from provider APIs, always up to date\n- **Background daemon** -- run 24/7 with pm2, auto-restart, and remote updates\n- **Reply \u0026 edit** -- reply to bot messages for context, edit sent messages to re-prompt\n\n## Quick Start\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) \u003e= 18\n- [OpenCode](https://github.com/opencode-ai/opencode) (`npm i -g opencode-ai@latest`)\n- A Telegram bot token from [@BotFather](https://t.me/BotFather)\n\n### Install\n\n```bash\nnpm install -g @4via6/relay\nrelay onboard\n```\n\nThe setup wizard walks through bot token, user ID, timezone, MCP tools, and voice transcription.\n\n## Running\n\n### Foreground\n\n```bash\nrelay\n```\n\n### Background (daemon)\n\n```bash\nrelay start                  # Start as background daemon\nrelay status                 # Show PID, uptime, memory\nrelay logs                   # Tail logs\nrelay restart                # Restart the daemon\nrelay stop                   # Stop the daemon\nrelay update                 # Update to latest version + restart\n```\n\n## Documentation\n\n| Guide | Description |\n|-------|-------------|\n| [Getting Started](docs/getting-started.md) | Installation, prerequisites, first steps |\n| [Configuration](docs/configuration.md) | All config options and CLI flags |\n| [Providers](docs/providers.md) | Detailed setup for each provider |\n| [Commands](docs/commands.md) | Full command reference with examples |\n| [Features](docs/features.md) | Streaming, file attachments, voice, MCP, models |\n| [Troubleshooting](docs/troubleshooting.md) | Common issues and solutions |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharsh-2002%2Frelay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharsh-2002%2Frelay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharsh-2002%2Frelay/lists"}