Smart support in every byte.
Transform any website into an AI-powered customer support agent in seconds.
SharkByte instantly creates an AI chatbot that can answer questions about any website. Just paste a URL, and we handle the rest - no FAQ writing, no training, no complex setup.
How it works:
- Enter a website URL
- We crawl and analyze the content
- Your AI support agent is ready to chat
- Instant Setup - No configuration required
- Website-Aware - Answers based on actual site content
- Streaming Responses - Real-time chat experience
- Theme Options - Light, Dark, and Ocean modes
- Mobile Friendly - Works on all devices
Homepage - Enter any URL to create an AI support agent
Agent configuration with embed code
AI chat powered by DigitalOcean Gradient
- Framework: Next.js 16.0 (App Router + Turbopack)
- UI Library: React 19.2
- Styling: Tailwind CSS v4 + shadcn/ui
- AI: DigitalOcean Gradient AI
- Deployment: Vercel
- Node.js 18+
- npm or yarn
- DigitalOcean account with Gradient AI enabled
# Clone the repository
git clone https://github.com/iamnolanhu/sharkbyte-support.git
cd sharkbyte-support
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your DigitalOcean API token
# Run development server
npm run devCreate a .env.local file:
# Required
DO_API_TOKEN=your_digitalocean_api_token # https://cloud.digitalocean.com/account/api/tokens
# DigitalOcean Gradient AI
DO_REGION=tor1 # Only tor1 supports gen-ai agents
DO_EMBEDDING_MODEL_UUID=bb3ab4ee-d9b5-11f0-b074-4e013e2ddde4 # Qwen3 (default)
DO_LLM_MODEL_UUID=18bc9b8f-73c5-11f0-b074-4e013e2ddde4 # GPT-oss-120b (default)
# Optional (auto-discovered if not set)
DO_PROJECT_ID=your_project_id # Auto-creates "SharkByte Support" project if not set
DO_DATABASE_ID=your_database_id # Reuse existing vector database
DO_MODEL_ACCESS_KEY_ID=your_key_id # Prevents duplicate key creation
FIRECRAWL_API_KEY=your_firecrawl_api_key # Fallback for SPAs (https://firecrawl.dev)
# Optional - Demo chat widget on landing page
NEXT_PUBLIC_DEMO_AGENT_ENDPOINT=https://your-demo-agent.agents.do-ai.run
NEXT_PUBLIC_DEMO_AGENT_ACCESS_KEY=your_demo_access_key- Open http://localhost:3000
- Enter a website URL
- Wait for the agent to be created
- Start chatting!
Add the chat widget to any website with a single script tag:
<script
src="https://sharkbyte-support.vercel.app/widget.js"
data-agent-id="your-agent-id"
data-endpoint="https://your-agent.agents.do-ai.run"
data-access-key="your-access-key"
data-primary-color="#0080FF"
data-position="bottom-right"
async
></script>Options:
data-primary-color- Widget accent color (hex)data-position-bottom-rightorbottom-leftdata-welcome-message- Custom greeting message
Cost Notice: Running SharkByte requires a DigitalOcean account with Gradient AI enabled. Estimated costs: ~$20/month for the vector database + variable AI usage. Get $200 in free credits to get started.
First-Time Setup: Fresh DO accounts must create one agent manually before API-based creation works.
Deploy to Vercel with one click:
Then add DO_API_TOKEN to your environment variables.
See DEPLOYMENT.md for the complete deployment guide, including:
- Step-by-step setup instructions
- Post-deployment optimization (prevent duplicate resources)
- Troubleshooting common issues
Or deploy manually:
npm run build
vercel deploy --prodsharkbyte-support/
├── public/
│ ├── images/ # Screenshots & hackathon photos
│ ├── sammy/ # Sammy mascot assets
│ └── widget.js # Embeddable chat widget
├── scripts/ # Dev utilities (cleanup, create-agent)
├── src/
│ ├── app/ # Next.js pages & API routes
│ ├── components/ # React components
│ ├── lib/ # DigitalOcean client, config, utils
│ ├── styles/ # Theme system
│ └── types/ # TypeScript interfaces
└── [config files] # package.json, tsconfig, etc.
The Sharks 🦈 - 3rd Place at MLH x DigitalOcean Hackathon 2025
Dual License - Free for non-commercial and open source use. Commercial use requires a paid license. See LICENSE for details.