{"id":44608261,"url":"https://github.com/sauravbhattacharya001/getagentbox","last_synced_at":"2026-04-26T06:01:06.084Z","repository":{"id":336789150,"uuid":"1151130695","full_name":"sauravbhattacharya001/getagentbox","owner":"sauravbhattacharya001","description":"AgentBox - Your personal AI agent that lives in Telegram. Web, reminders, image understanding, and more.","archived":false,"fork":false,"pushed_at":"2026-04-19T03:52:19.000Z","size":1600,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-19T05:31:20.989Z","etag":null,"topics":["agentbox","ai-agent","ai-assistant","chatbot","conversational-ai","docker","github-pages","html-css-js","interactive-ui","javascript","landing-page","marketing","npm-package","open-source","product-landing","roi-calculator","saas","telegram-bot","web-components","zero-dependencies"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/sauravbhattacharya001.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"roadmap.html","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-06T04:54:41.000Z","updated_at":"2026-04-19T03:52:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sauravbhattacharya001/getagentbox","commit_stats":null,"previous_names":["sauravbhattacharya001/getagentbox"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/sauravbhattacharya001/getagentbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sauravbhattacharya001%2Fgetagentbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sauravbhattacharya001%2Fgetagentbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sauravbhattacharya001%2Fgetagentbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sauravbhattacharya001%2Fgetagentbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sauravbhattacharya001","download_url":"https://codeload.github.com/sauravbhattacharya001/getagentbox/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sauravbhattacharya001%2Fgetagentbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32287398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"online","status_checked_at":"2026-04-26T02:00:05.962Z","response_time":129,"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":["agentbox","ai-agent","ai-assistant","chatbot","conversational-ai","docker","github-pages","html-css-js","interactive-ui","javascript","landing-page","marketing","npm-package","open-source","product-landing","roi-calculator","saas","telegram-bot","web-components","zero-dependencies"],"created_at":"2026-02-14T11:25:54.148Z","updated_at":"2026-04-26T06:01:06.077Z","avatar_url":"https://github.com/sauravbhattacharya001.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🤖 AgentBox\n\n**Your personal AI agent that lives in Telegram**\n\n[![Try on Telegram](https://img.shields.io/badge/💬_Try_Now-Telegram-26A5E4?style=for-the-badge\u0026logo=telegram\u0026logoColor=white)](https://t.me/AgentBox11Bot)\n[![Live Site](https://img.shields.io/badge/🌐_Visit-Landing_Page-00C853?style=for-the-badge)](https://sauravbhattacharya001.github.io/getagentbox/)\n\n\u003cbr\u003e\n\n[![CI](https://github.com/sauravbhattacharya001/getagentbox/actions/workflows/ci.yml/badge.svg)](https://github.com/sauravbhattacharya001/getagentbox/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/sauravbhattacharya001/getagentbox/branch/master/graph/badge.svg)](https://codecov.io/gh/sauravbhattacharya001/getagentbox)\n[![Deploy](https://github.com/sauravbhattacharya001/getagentbox/actions/workflows/pages.yml/badge.svg)](https://github.com/sauravbhattacharya001/getagentbox/actions/workflows/pages.yml)\n[![Docker](https://github.com/sauravbhattacharya001/getagentbox/actions/workflows/docker.yml/badge.svg)](https://github.com/sauravbhattacharya001/getagentbox/actions/workflows/docker.yml)\n[![HTML5](https://img.shields.io/badge/HTML5-E34F26?logo=html5\u0026logoColor=white)](#-tech-stack)\n[![CSS3](https://img.shields.io/badge/CSS3-1572B6?logo=css3\u0026logoColor=white)](#-tech-stack)\n[![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript\u0026logoColor=black)](#-tech-stack)\n[![Docker](https://img.shields.io/badge/Docker-2496ED?logo=docker\u0026logoColor=white)](#-docker)\n[![License](https://img.shields.io/github/license/sauravbhattacharya001/getagentbox)](LICENSE)\n[![npm](https://img.shields.io/npm/v/agentbox-landing?logo=npm\u0026logoColor=white)](https://www.npmjs.com/package/agentbox-landing)\n[![Docs](https://img.shields.io/badge/Docs-API_Reference-blue?logo=readthedocs\u0026logoColor=white)](https://sauravbhattacharya001.github.io/getagentbox/docs/)\n[![Last Commit](https://img.shields.io/github/last-commit/sauravbhattacharya001/getagentbox)](https://github.com/sauravbhattacharya001/getagentbox/commits/master)\n[![Repo Size](https://img.shields.io/github/repo-size/sauravbhattacharya001/getagentbox)](https://github.com/sauravbhattacharya001/getagentbox)\n[![Stars](https://img.shields.io/github/stars/sauravbhattacharya001/getagentbox?style=flat)](https://github.com/sauravbhattacharya001/getagentbox/stargazers)\n\nAn AI assistant that remembers you, searches the web, sets reminders, understands images, and lives right in Telegram. No signup, no app to install — just open Telegram and start chatting.\n\n\u003c/div\u003e\n\n---\n\n## ⚡ Quick Start\n\n```\n1. Open Telegram\n2. Search for @AgentBox11Bot\n3. Tap \"Start\"\n4. Chat — 20 free messages/day, no signup required\n```\n\nThat's it. No accounts, no apps, no configuration.\n\n---\n\n## ✨ Features\n\n| | Feature | Description |\n|---|---|---|\n| 🧠 | **Persistent Memory** | Learns your preferences, context, and history across conversations. Never repeat yourself. |\n| 🔍 | **Web Search** | Ask about anything — get concise, grounded answers backed by live web data. |\n| ⏰ | **Smart Reminders** | Natural language scheduling. \"Remind me to call mom in 30 minutes\" just works. |\n| 📷 | **Vision** | Send photos, screenshots, documents, memes — it sees what you see and answers questions about them. |\n| 🎤 | **Voice** | Send a voice note instead of typing. It transcribes and responds naturally. |\n| 🔒 | **Private Workspace** | Each user gets an isolated agent. Your conversations and data stay yours. |\n\n---\n\n## 🆚 Comparison\n\n| Feature | AgentBox | ChatGPT | Siri / Google |\n|:---|:---:|:---:|:---:|\n| Remembers your context | ✅ | ⚠️ | ❌ |\n| Lives in Telegram | ✅ | ❌ | ❌ |\n| Web search | ✅ | ✅ | ✅ |\n| Image understanding | ✅ | ✅ | ⚠️ |\n| Voice messages | ✅ | ✅ | ✅ |\n| Set reminders | ✅ | ❌ | ✅ |\n| No app to install | ✅ | ❌ | ⚠️ |\n| Free tier | ✅ | ✅ | ✅ |\n| Private workspace | ✅ | ⚠️ | ❌ |\n\n---\n\n## 💬 Interactive Demo\n\nThe [live landing page](https://sauravbhattacharya001.github.io/getagentbox/) includes animated Telegram-style chat demos across four scenarios:\n\n- **🧠 Memory** — Recalls past conversations and uses them as context\n- **🔍 Search** — Answers real-world questions with live web data\n- **⏰ Reminder** — Natural language scheduling that just works\n- **📷 Image** — Analyzes screenshots and images to solve problems\n\n---\n\n## 🏗️ Architecture\n\n```\n┌──────────────────────────────────────┐\n│        Landing Page (this repo)      │\n│                                      │\n│  Multi-page static site with:        │\n│  • 30+ pages (landing, docs, tools)  │\n│  • 50+ modular JS components         │\n│  • Comparison table                  │\n│  • FAQ accordion                     │\n│  • CTA → Telegram bot               │\n│                                      │\n│  Deployed via GitHub Pages           │\n└───────────────┬──────────────────────┘\n                │ Links to\n                ▼\n┌──────────────────────────────────────┐\n│       Telegram Bot Backend           │\n│                                      │\n│  ┌──────────┐  ┌─────────────────┐   │\n│  │ GPT-4o / │  │ Per-user memory │   │\n│  │ Claude   │  │ \u0026 workspace    │   │\n│  └──────────┘  └─────────────────┘   │\n│  ┌──────────┐  ┌─────────────────┐   │\n│  │ Web      │  │ Reminder       │   │\n│  │ Search   │  │ Scheduler      │   │\n│  └──────────┘  └─────────────────┘   │\n└──────────────────────────────────────┘\n```\n\n\u003e This repository contains the **landing site** — a multi-page static site with 30+ pages and 50+ interactive JS modules, deployed via GitHub Pages. The bot backend runs separately and communicates through the Telegram Bot API.\n\n---\n\n## 🛠️ Tech Stack\n\n| Layer | Technology | Purpose |\n|:---|:---|:---|\n| **Frontend** | HTML5 + CSS3 + Vanilla JS | Zero-dependency, single-file landing page |\n| **Hosting** | GitHub Pages | Free static hosting with automatic HTTPS |\n| **Container** | Docker (nginx:alpine) | Production-ready containerized deployment |\n| **Bot** | Telegram Bot API | Messaging platform integration |\n| **AI** | GPT-4o, Claude | Language understanding + generation + vision |\n| **Analytics** | GoatCounter | Privacy-friendly, cookie-free tracking |\n| **CI** | GitHub Actions | HTML validation, link checks, accessibility audit |\n\n---\n\n## 📁 Project Structure\n\n```\ngetagentbox/\n├── index.html                              # Main landing page\n├── styles.css                              # Global styling (dark theme, responsive)\n├── app.js                                  # Interactive component orchestrator\n├── cookie-consent.js                       # GDPR-compliant cookie consent\n├── keyboard-shortcuts.js                   # Keyboard navigation support\n├── build.js                                # Build script\n│\n├── # ─── Site Pages (30+) ───\n├── compare.html                            # Feature comparison matrix\n├── faq.html                                # FAQ page\n├── api-docs.html                           # API documentation\n├── tutorials.html                          # User tutorials\n├── blog.html                               # Blog / updates\n├── community.html                          # Community hub\n├── integrations.html                       # Integration catalog\n├── onboarding.html                         # Onboarding wizard\n├── roi-calculator.html                     # ROI calculator tool\n├── use-case-explorer.html                  # Interactive use case explorer\n├── status-page.html                        # Service status dashboard\n├── uptime-history.html                     # Historical uptime data\n├── security-whitepaper.html                # Security documentation\n├── accessibility.html                      # Accessibility statement\n├── testimonials.html                       # User testimonials\n├── privacy.html / terms.html / sla.html    # Legal pages\n├── careers.html / partners.html            # Company pages\n├── 404.html                                # Custom error page\n├── ... (and more)\n│\n├── src/                                    # npm package source\n│   ├── index.js                            # Package entry (FAQ, Pricing, Stats)\n│   ├── roi-calculator.js                   # ROI calculator logic\n│   ├── capability-radar.js                 # Capability radar chart\n│   ├── workflow-builder.js                 # Visual workflow builder\n│   ├── command-reference.js                # Command reference engine\n│   └── modules/                            # 50+ modular UI components\n│       ├── chat-demo.js                    # Animated chat simulation\n│       ├── pricing.js                      # Pricing toggle \u0026 tiers\n│       ├── faq.js                          # FAQ accordion\n│       ├── stats.js                        # Animated statistics\n│       ├── playground.js                   # Interactive playground\n│       ├── api-explorer.js                 # API explorer widget\n│       ├── command-palette.js              # Cmd+K command palette\n│       ├── pipeline-builder.js             # Visual pipeline builder\n│       ├── onboarding-quiz.js              # Onboarding questionnaire\n│       ├── personality-configurator.js     # Agent personality config\n│       ├── prompt-gallery.js               # Prompt template gallery\n│       ├── theme-toggle.js                 # Light/dark theme toggle\n│       ├── site-nav.js                     # Navigation system\n│       └── ... (40+ more modules)\n│\n├── docs/                                   # Developer documentation\n│   ├── index.html                          # API reference\n│   ├── getting-started.html                # Setup guide\n│   ├── architecture.html                   # Architecture overview\n│   ├── changelog.html                      # Visual changelog\n│   ├── customization.md                    # Customization guide\n│   └── modules.md                          # Module documentation\n│\n├── vendor/                                 # Vendored dependencies\n├── __tests__/                              # Jest test suites\n├── Dockerfile                              # Multi-stage nginx container\n├── .dockerignore                           # Docker build exclusions\n├── codecov.yml                             # Code coverage config\n├── CONTRIBUTING.md                         # Contribution guidelines\n├── CHANGELOG.md                            # Release changelog\n├── LICENSE                                 # MIT License\n│\n└── .github/\n    ├── copilot-setup-steps.yml             # GitHub Copilot coding agent config\n    ├── copilot-instructions.md             # Repo context for AI agents\n    ├── pull_request_template.md            # PR template\n    ├── ISSUE_TEMPLATE/                     # Issue form templates\n    └── workflows/\n        ├── ci.yml                          # CI: validate, lint, a11y audit\n        ├── pages.yml                       # Auto-deploy to GitHub Pages\n        ├── publish.yml                     # npm publish on release\n        └── docker.yml                      # Docker build/push\n```\n\n---\n\n## 🧑‍💻 Development\n\n### npm Package\n\nThe interactive components are also available as a reusable npm package:\n\n```bash\nnpm install agentbox-landing\n```\n\n```js\nconst { FAQ, Pricing, Stats } = require('agentbox-landing');\n\n// Initialize FAQ accordion\nFAQ.init('.faq-section');\n\n// Initialize pricing toggle\nPricing.init('.billing-toggle');\n\n// Animate stats on scroll\nStats.init('.stats-section', { duration: 2000 });\n```\n\nSee the [API docs](https://sauravbhattacharya001.github.io/getagentbox/docs/) for full reference.\n\n### Local Preview\n\n```bash\n# Clone the repository\ngit clone https://github.com/sauravbhattacharya001/getagentbox.git\ncd getagentbox\n\n# Serve locally (pick one)\npython -m http.server 8000\n# or\nnpx serve .\n# or\nphp -S localhost:8000\n\n# Open http://localhost:8000\n```\n\nNo build step required for page edits. Modify HTML/CSS/JS and refresh your browser.\n\n### 🐳 Docker\n\n```bash\n# Build the container\ndocker build -t agentbox-landing .\n\n# Run it\ndocker run -p 8080:8080 agentbox-landing\n\n# Open http://localhost:8080\n```\n\nThe Dockerfile uses a multi-stage build:\n1. **Stage 1** — Validates HTML with `html-validate` (build fails if invalid)\n2. **Stage 2** — Serves via `nginx:alpine` with security headers, gzip, and a `/healthz` endpoint\n\nRuns as a non-root user for production security.\n\n---\n\n## 🔒 Security\n\nThe landing page includes several security measures:\n\n- **Content Security Policy** — Restricts script/style/image sources\n- **X-Content-Type-Options** — Prevents MIME-type sniffing\n- **Referrer Policy** — Controls referrer information leakage\n- **`rel=\"noopener noreferrer\"`** — On all external links\n- **Docker** — Non-root user, minimal Alpine image, security headers via nginx\n\n---\n\n## 🎨 Design Decisions\n\n- **Minimal build** — Zero heavy toolchain, instant deploy, no bundler required\n- **Dark theme** — Gradient accents matching the Telegram aesthetic\n- **Responsive** — Works down to 320px width\n- **No external deps** — Loads fast everywhere, no CDN dependency\n- **Interactive demos** — Animated chat simulations to show real usage patterns\n- **Privacy-first analytics** — GoatCounter (cookie-free, GDPR-compliant)\n\n---\n\n## CI Pipeline\n\nThe CI workflow runs on every push and PR:\n\n| Job | What it checks |\n|:---|:---|\n| **HTML Validation** | Validates `index.html` against html-validate rules |\n| **Structure Check** | DOCTYPE, lang, charset, viewport, title, meta description, OG tags |\n| **Link Validation** | All external links in `index.html` and `README.md` (via lychee) |\n| **Accessibility** | WCAG 2.0 AA audit via pa11y |\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! This is a simple static site, so getting started is straightforward:\n\n1. **Fork** the repository\n2. **Create** a feature branch: `git checkout -b feature/your-idea`\n3. **Edit** `index.html` — that's the entire codebase\n4. **Test** locally with any static file server\n5. **Open** a Pull Request\n\n### Ideas for contributions\n\n- ♿ Accessibility improvements (ARIA labels, keyboard navigation, focus styles)\n- 🌍 Internationalization / localization\n- 🎭 Additional demo scenarios\n- ⚡ Performance optimizations\n- 🔍 SEO improvements (structured data, Twitter cards)\n- 📱 PWA support (service worker, manifest)\n\n---\n\n## 📄 License\n\n© [Saurav Bhattacharya](https://github.com/sauravbhattacharya001). All rights reserved.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[🌐 Live Site](https://sauravbhattacharya001.github.io/getagentbox/)** · **[💬 Try on Telegram](https://t.me/AgentBox11Bot)** · **[🐛 Report Bug](https://github.com/sauravbhattacharya001/getagentbox/issues/new?template=bug_report.yml)** · **[💡 Request Feature](https://github.com/sauravbhattacharya001/getagentbox/issues/new?template=feature_request.yml)**\n\nBuilt by [Saurav Bhattacharya](https://github.com/sauravbhattacharya001)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsauravbhattacharya001%2Fgetagentbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsauravbhattacharya001%2Fgetagentbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsauravbhattacharya001%2Fgetagentbox/lists"}