Skip to content

sauravbhattacharya001/getagentbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

375 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 AgentBox

Your personal AI agent that lives in Telegram

Try on Telegram Live Site


CI codecov Deploy Docker CodeQL HTML5 CSS3 JavaScript Docker License npm npm downloads GitHub release Docs Website Dependabot Last Commit Repo Size Stars Issues PRs Welcome Maintenance

An 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.

83 HTML pages · 67 JS modules · 71 test suites


⚡ Quick Start

1. Open Telegram
2. Search for @AgentBox11Bot
3. Tap "Start"
4. Chat — 20 free messages/day, no signup required

That's it. No accounts, no apps, no configuration.


✨ Features

Feature Description
🧠 Persistent Memory Learns your preferences, context, and history across conversations. Never repeat yourself.
🔍 Web Search Ask about anything — get concise, grounded answers backed by live web data.
Smart Reminders Natural language scheduling. "Remind me to call mom in 30 minutes" just works.
📷 Vision Send photos, screenshots, documents, memes — it sees what you see and answers questions about them.
🎤 Voice Send a voice note instead of typing. It transcribes and responds naturally.
🔒 Private Workspace Each user gets an isolated agent. Your conversations and data stay yours.

🆚 Comparison

Feature AgentBox ChatGPT Siri / Google
Remembers your context ⚠️
Lives in Telegram
Web search
Image understanding ⚠️
Voice messages
Set reminders
No app to install ⚠️
Free tier
Private workspace ⚠️

💬 Interactive Demo

The live landing page includes animated Telegram-style chat demos across four scenarios:

  • 🧠 Memory — Recalls past conversations and uses them as context
  • 🔍 Search — Answers real-world questions with live web data
  • ⏰ Reminder — Natural language scheduling that just works
  • 📷 Image — Analyzes screenshots and images to solve problems

🧰 Pages & Interactive Tools

The site includes 75+ standalone pages organized across seven categories:

Planning & Analysis

Page Description
ROI Calculator Calculate time and cost savings from agent automation
Capacity Planner Estimate infrastructure needs for your workload
Decision Matrix Compare AgentBox against alternatives with weighted criteria
Capability Matrix Feature-by-feature breakdown of agent capabilities
Readiness Assessment Evaluate whether your team is ready for AI agents
Cost Optimizer Optimize agent costs across tiers and usage patterns
Scenario Planner Simulate agent deployment scenarios and outcomes

Development & Integration

Page Description
API Docs Full API reference for programmatic integration
CLI Playground Try AgentBox CLI commands in an interactive terminal
Webhooks Configure and test webhook integrations
SDK SDK documentation for building on top of AgentBox
Sandbox Isolated testing environment for experiments
Architecture System architecture overview and design decisions
Dependency Mapper Visualize service and module dependencies
Marketplace Browse and install agent extensions and plugins

Agent Intelligence

Page Description
Persona Creator Design custom agent personalities
Autonomy Ladder Configure agent autonomy levels
Memory Palace Visualize and manage agent memory
Sentiment Analyzer Real-time conversation sentiment tracking
Task Decomposer Break complex tasks into agent-executable steps
Evolution Lab Experiment with agent behavior evolution
Negotiation Arena Multi-agent negotiation simulations
Empathy Engine Emotional intelligence and empathy-aware responses
Reasoning Trace Inspect step-by-step reasoning chains
Knowledge Distillation Extract and compress knowledge from agent interactions
Calibration Lab Fine-tune agent confidence and response calibration
Digital Twin Create and manage digital twin simulations
Swarm Orchestrator Coordinate multi-agent swarm behaviors

Operations & Monitoring

Page Description
Status Page Live service health dashboard
Uptime History Historical availability data
Pulse Monitor Real-time system metrics
Metrics Simulator Simulate load and capacity scenarios
SLA Dashboard Service level agreement tracking
Watchdog Automated health monitoring
Postmortems Incident analysis and learnings
Lifecycle Manager Agent lifecycle state machine management
War Room Collaborative incident response dashboard
Autopsy Deep analysis of failed agent interactions
Feedback Loop Continuous improvement via user feedback

Trust & Security

Page Description
Trust Score Real-time agent trust scoring and breakdown
Trust Evolution Track trust changes over time
Threat Model Interactive threat modeling for agent deployments
Red Team Arena Adversarial testing playground
Security Whitepaper Comprehensive security documentation
Voting Community governance and feature voting

Resources

Page Description
Tutorials Step-by-step guides for common workflows
Use Case Explorer Interactive use case discovery
Knowledge Base Searchable help articles
Glossary AI and agent terminology
Workflow Builder Visual drag-and-drop workflow designer
Migration Guide Migrate from other AI assistants
Case Studies Real-world deployment case studies
Roadmap Public product roadmap and feature timeline
Blog Product updates, technical deep-dives
Events Upcoming events, webinars, and demos

Community & Business

Page Description
Community Community hub and showcase
Testimonials User testimonials and success stories
Affiliate Affiliate and referral program
Partners Technology and integration partners
Careers Open positions and team culture
Contact Get in touch
Press Kit Brand assets, logos, and media resources
Badges Embeddable trust and integration badges

🏗️ Architecture

┌──────────────────────────────────────────────┐
│          Landing Site (this repo)             │
│                                              │
│  83 HTML pages · 67 JS modules · 71 tests    │
│                                              │
│  ┌────────────┐  ┌────────────────────────┐  │
│  │ index.html │  │ 75+ tool/resource      │  │
│  │ (landing)  │  │ pages (calculators,    │  │
│  │            │  │ monitors, labs, docs)  │  │
│  └────────────┘  └────────────────────────┘  │
│  ┌────────────────────────────────────────┐  │
│  │ src/modules/ — 55 UI components        │  │
│  │ src/*.js    — 12 page-level modules    │  │
│  │ vendor/     — Vendored dependencies    │  │
│  └────────────────────────────────────────┘  │
│                                              │
│  Deployed via GitHub Pages                   │
└───────────────────┬──────────────────────────┘
                    │ Links to
                    ▼
┌──────────────────────────────────────────────┐
│          Telegram Bot Backend                │
│                                              │
│  ┌──────────┐  ┌─────────────────────────┐   │
│  │ GPT-4o / │  │ Per-user memory         │   │
│  │ Claude   │  │ & workspace             │   │
│  └──────────┘  └─────────────────────────┘   │
│  ┌──────────┐  ┌─────────────────────────┐   │
│  │ Web      │  │ Reminder                │   │
│  │ Search   │  │ Scheduler               │   │
│  └──────────┘  └─────────────────────────┘   │
└──────────────────────────────────────────────┘

This repository contains the landing site — a multi-page static site with 83 pages and 67 interactive JS modules, deployed via GitHub Pages. The bot backend runs separately and communicates through the Telegram Bot API.


🛠️ Tech Stack

Layer Technology Purpose
Frontend HTML5 + CSS3 + Vanilla JS Zero-dependency, multi-page static site
Hosting GitHub Pages Free static hosting with automatic HTTPS
Container Docker (nginx:alpine) Production-ready containerized deployment
Bot Telegram Bot API Messaging platform integration
AI GPT-4o, Claude Language understanding + generation + vision
Analytics GoatCounter Privacy-friendly, cookie-free tracking
CI GitHub Actions HTML validation, link checks, accessibility audit
Testing Jest 71 test suites with coverage thresholds
Security CodeQL + Dependabot Automated vulnerability scanning and dependency updates
Package npm (agentbox-landing) Reusable interactive components

📁 Project Structure

getagentbox/
├── index.html                              # Main landing page
├── styles.css                              # Global styling (dark theme, responsive)
├── cookie-consent.js                       # GDPR-compliant cookie consent
├── build.js                                # Build script (template processing)
│
├── # ─── Site Pages (75+ HTML files) ───
├── compare.html                            # Feature comparison matrix
├── faq.html                                # FAQ page
├── api-docs.html                           # API documentation
├── tutorials.html                          # User tutorials
├── blog.html / updates.html                # Blog and product updates
├── community.html                          # Community hub
├── integrations.html                       # Integration catalog
├── onboarding.html                         # Onboarding wizard
├── roi-calculator.html                     # ROI calculator tool
├── cost-optimizer.html                     # Cost optimization tool
├── use-case-explorer.html                  # Interactive use case explorer
├── status-page.html                        # Service status dashboard
├── uptime-history.html                     # Historical uptime data
├── war-room.html                           # Incident response dashboard
├── autopsy.html                            # Failed interaction analysis
├── persona-creator.html                    # Agent personality designer
├── autonomy-ladder.html                    # Autonomy level configuration
├── memory-palace.html                      # Agent memory visualizer
├── empathy-engine.html                     # Emotional intelligence engine
├── reasoning-trace.html                    # Reasoning chain inspector
├── swarm-orchestrator.html                 # Multi-agent swarm coordination
├── digital-twin.html                       # Digital twin simulations
├── calibration-lab.html                    # Response calibration lab
├── knowledge-distillation.html             # Knowledge extraction tool
├── trust-score.html / trust-evolution.html # Trust scoring and tracking
├── red-team-arena.html                     # Adversarial testing
├── threat-model.html                       # Threat modeling tool
├── security-whitepaper.html                # Security documentation
├── accessibility.html                      # Accessibility statement
├── privacy.html / terms.html / sla.html    # Legal pages
├── careers.html / partners.html            # Company pages
├── affiliate.html                          # Referral program
├── case-studies.html                       # Deployment case studies
├── press-kit.html                          # Media and brand assets
├── voting.html                             # Community governance
├── 404.html                                # Custom error page
├── sitemap.html                            # Site map
├── ... (and more)
│
├── src/                                    # npm package source (67 modules)
│   ├── index.js                            # Package entry (FAQ, Pricing, Stats)
│   ├── roi-calculator.js                   # ROI calculator logic
│   ├── capability-radar.js                 # Capability radar chart
│   ├── workflow-builder.js                 # Visual workflow builder
│   ├── command-reference.js                # Command reference engine
│   ├── autonomy-ladder.js                  # Autonomy level logic
│   ├── benchmarks.js                       # Performance benchmarks
│   ├── calibration-lab.js                  # Calibration lab logic
│   ├── events-page.js                      # Events page logic
│   ├── migration-guide.js                  # Migration guide logic
│   ├── role-demo-picker.js                 # Role-based demo selector
│   ├── use-case-explorer.js                # Use case explorer logic
│   └── modules/                            # 55 modular UI components
│       ├── chat-demo.js                    # Animated chat simulation
│       ├── pricing.js                      # Pricing toggle & tiers
│       ├── faq.js                          # FAQ accordion
│       ├── stats.js                        # Animated statistics
│       ├── playground.js                   # Interactive playground
│       ├── api-explorer.js                 # API explorer widget
│       ├── command-palette.js              # Cmd+K command palette
│       ├── pipeline-builder.js             # Visual pipeline builder
│       ├── onboarding-quiz.js              # Onboarding questionnaire
│       ├── personality-configurator.js     # Agent personality config
│       ├── prompt-gallery.js               # Prompt template gallery
│       ├── theme-toggle.js                 # Light/dark theme toggle
│       ├── site-nav.js                     # Navigation system
│       ├── activity-feed.js                # Real-time activity feed
│       ├── capacity-planner.js             # Capacity planning tool
│       ├── help-chat-widget.js             # In-page help chat
│       ├── privacy-checkup.js              # Privacy audit tool
│       ├── referral-program.js             # Referral program logic
│       ├── scenario-planner.js             # Scenario planning tool
│       ├── scroll-progress.js              # Reading progress indicator
│       ├── section-minimap.js              # Page section minimap
│       ├── share-card-generator.js         # Social share card generator
│       ├── social-proof-toasts.js          # Social proof notifications
│       ├── speed-challenge.js              # Interactive speed benchmarks
│       ├── status-dashboard.js             # Status dashboard widget
│       ├── storage.js                      # Client-side storage layer
│       ├── workflow-templates.js           # Workflow template library
│       └── ... (28 more modules)
│
├── docs/                                   # Developer documentation (8 pages)
│   ├── index.html                          # API reference
│   ├── getting-started.html                # Setup guide
│   ├── architecture.html                   # Architecture overview
│   ├── changelog.html                      # Visual changelog
│   ├── component-catalog.html              # Component gallery
│   ├── deployment.html                     # Deployment guide
│   ├── performance.html                    # Performance guide
│   ├── plugin-development.html             # Plugin development guide
│   ├── customization.md                    # Customization guide
│   ├── modules.md                          # Module documentation
│   └── TESTING.md                          # Testing guide & conventions
│
├── vendor/                                 # Vendored dependencies
├── __tests__/                              # 71 Jest test suites
│
├── Dockerfile                              # Multi-stage nginx container
├── .dockerignore                           # Docker build exclusions
├── package.json                            # npm package config (agentbox-landing)
├── jest.config.js                          # Jest configuration
├── codecov.yml                             # Code coverage config
├── CONTRIBUTING.md                         # Contribution guidelines
├── CHANGELOG.md                            # Release changelog
├── SECURITY.md                             # Security policy
├── LICENSE                                 # MIT License
│
├── dist/                                   # Built distribution files
│
└── .github/
    ├── copilot-setup-steps.yml             # GitHub Copilot coding agent config
    ├── copilot-instructions.md             # Repo context for AI agents
    ├── pull_request_template.md            # PR template
    ├── dependabot.yml                      # Dependabot config
    ├── ISSUE_TEMPLATE/                     # Issue form templates
    └── workflows/
        ├── ci.yml                          # CI: validate, lint, a11y audit
        ├── pages.yml                       # Auto-deploy to GitHub Pages
        ├── publish.yml                     # npm publish on release
        ├── docker.yml                      # Docker build/push
        └── codeql.yml                      # CodeQL security scanning

🧑‍💻 Development

npm Package

The interactive components are also available as a reusable npm package:

npm install agentbox-landing
const { FAQ, Pricing, Stats } = require('agentbox-landing');

// Initialize FAQ accordion
FAQ.init('.faq-section');

// Initialize pricing toggle
Pricing.init('.billing-toggle');

// Animate stats on scroll
Stats.init('.stats-section', { duration: 2000 });

See the API docs for full reference.

Local Preview

# Clone the repository
git clone https://github.com/sauravbhattacharya001/getagentbox.git
cd getagentbox

# Serve locally (pick one)
python -m http.server 8000
# or
npx serve .
# or
php -S localhost:8000

# Open http://localhost:8000

No build step required for page edits. Modify HTML/CSS/JS and refresh your browser.

Build

# Install dev dependencies (Jest for testing)
npm install

# Run the build script (processes templates)
node build.js

🐳 Docker

# Build the container
docker build -t agentbox-landing .

# Run it
docker run -p 8080:8080 agentbox-landing

# Open http://localhost:8080

The Dockerfile uses a multi-stage build:

  1. Stage 1 — Validates HTML with html-validate (build fails if invalid)
  2. Stage 2 — Serves via nginx:alpine with security headers, gzip, and a /healthz endpoint

Runs as a non-root user for production security.


🧪 Testing

71 test suites covering all interactive modules, page logic, security hardening, and edge cases.

# Run all tests
npm test

# Run with coverage report
npm run test:coverage

# Run a specific test
npx jest __tests__/storage.test.js

Coverage thresholds (enforced in CI): 70% lines, 70% statements, 60% branches, 60% functions.

Test categories include:

  • Module tests — Individual UI component behavior (chat-demo, pricing, FAQ, playground, etc.)
  • Page-level tests — Full-page logic for ROI calculator, capacity planner, autonomy ladder, calibration lab
  • Security tests — LocalStorage security, refactored security patterns, input sanitization
  • Integration tests — DOM utils, storage layer, site navigation, theme toggle
  • Edge case tests — Bugfix regression tests, feedback edge cases, performance caching

See the full Testing Guide for architecture details, conventions, and troubleshooting.


🔒 Security

See SECURITY.md for the full security policy and vulnerability reporting process.

  • Strict CSPdefault-src 'self' with no inline scripts or external CDNs
  • XSS-hardened — No user input in innerHTML; all dynamic content from static app data
  • Vendored dependencies — GoatCounter loaded locally, eliminating CDN supply-chain risk
  • 9 security headers — CSP, HSTS, COOP, COEP, CORP, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy
  • Docker — Non-root user, multi-stage build, Alpine minimal image, health checks
  • No cookies — Privacy-first analytics via GoatCounter
  • CodeQL — Automated code scanning for JS/HTML vulnerabilities
  • Dependabot — Automated dependency updates with security alerts

🎨 Design Decisions

  • Minimal build — Zero heavy toolchain, instant deploy, no bundler required
  • Dark theme — Gradient accents matching the Telegram aesthetic
  • Responsive — Works down to 320px width
  • No external deps — Loads fast everywhere, no CDN dependency
  • Interactive demos — Animated chat simulations to show real usage patterns
  • Privacy-first analytics — GoatCounter (cookie-free, GDPR-compliant)
  • Modular architecture — 55 self-contained UI components in src/modules/

⌨️ Keyboard Shortcuts

The site supports keyboard navigation for power users:

Shortcut Action
? Open keyboard shortcuts help overlay
Ctrl+K / ⌘+K Open command palette
T Toggle light/dark theme
Esc Close overlays and modals

Full accessibility support includes skip-to-content links, ARIA labels, focus management, and screen reader announcements.


CI Pipeline

The CI workflow runs on every push and PR:

Job What it checks
HTML Validation Validates index.html against html-validate rules
Structure Check DOCTYPE, lang, charset, viewport, title, meta description, OG tags
Link Validation All external links in index.html and README.md (via lychee)
Accessibility WCAG 2.0 AA audit via pa11y
Tests 71 Jest test suites with coverage thresholds
CodeQL Static analysis for security vulnerabilities

🤝 Contributing

Contributions are welcome! This is a simple static site, so getting started is straightforward:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/your-idea
  3. Make changes and test locally
  4. Run tests: npm test
  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Ideas for contributions

  • ♿ Accessibility improvements (ARIA labels, keyboard navigation, focus styles)
  • 🌍 Internationalization / localization
  • 🎭 Additional demo scenarios
  • ⚡ Performance optimizations
  • 🔍 SEO improvements (structured data, Twitter cards)
  • 📱 PWA support (service worker, manifest)
  • 🧩 New interactive tools and pages

📄 License

MIT License — © Saurav Bhattacharya