Docs/Getting Started/Introduction

Introduction

What SkyKoi is and how it deploys AI agents for your business.

SkyKoi is a B2B platform that deploys and manages dedicated AI agent instances for businesses. Each customer gets a dedicated EC2 instance running an isolated AI assistant powered by Claude Opus 4.6 via AWS Bedrock โ€” with full shell access, file operations, web browsing, and more.

What is SkyKoi?

Running a dedicated AI agent requires provisioning a server, installing dependencies, configuring the Gateway daemon, setting up TLS, managing IAM roles, and wiring up channel credentials. That's a lot of infrastructure work before you can even start chatting.

SkyKoi abstracts all of that complexity into a single experience. You sign up, visit the Chat page, and a dedicated EC2 instance is automatically provisioned for you โ€” complete with the Koi runtime, nginx, TLS, and a live AI agent. The entire provisioning process takes about 2โ€“3 minutes.

Key Features

  • โ€ขDedicated EC2 Instance โ€” Each user gets their own t3.small instance (Ubuntu 22.04) in us-east-1 with complete process, filesystem, and network isolation
  • โ€ขAuto-Provisioning โ€” On first visit to Chat, your server is launched and configured automatically โ€” no manual setup required
  • โ€ขClaude Opus 4.6 via AWS Bedrock โ€” Powered by amazon-bedrock/us.anthropic.claude-opus-4-6-v1 for enterprise-grade AI capabilities
  • โ€ขFull Agent Runtime โ€” Your agent can read/write files, execute shell commands, browse the web, search the internet, analyze images, generate speech, run cron jobs, and spawn sub-agents
  • โ€ขInfrastructure as Conversation โ€” Agents can manage AWS resources (EC2, S3, Lambda, RDS, CloudFormation) through natural language
  • โ€ขWebChat Interface โ€” Real-time chat via WSS (nginx reverse proxy with self-signed TLS)
  • โ€ขTeam Collaboration โ€” Role-based access control with Owner, Admin, Member, and Viewer roles
  • โ€ขUsage Analytics โ€” Real-time dashboards showing token usage, conversation metrics, and agent health
  • โ€ขEnterprise Security โ€” Clerk auth, token-based Gateway auth, dedicated instance isolation, and IAM roles

How It Works (High Level)

text
Customer Dashboard (skykoi.com)
        โ”‚
        โ–ผ
  SkyKoi API (Next.js on Vercel)
        โ”‚
        โ–ผ
  EC2 Provisioner (us-east-1)
        โ”‚
        โ–ผ
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  โ”‚  Dedicated EC2 Instance (t3.small)โ”‚
  โ”‚  Ubuntu 22.04 ยท nginx ยท TLS      โ”‚
  โ”‚                                   โ”‚
  โ”‚  Koi Gateway (systemd)   โ”‚
  โ”‚     โ”‚                             โ”‚
  โ”‚     โ–ผ                             โ”‚
  โ”‚  Agent Runtime                    โ”‚
  โ”‚  (Claude Opus 4.6 via Bedrock)    โ”‚
  โ”‚                                   โ”‚
  โ”‚  WebChat โ”€โ”€โ–ถ WSS (port 443)       โ”‚
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

The Gateway is a long-lived daemon that runs as a systemd service. The embedded agent runtime uses Claude Opus 4.6 via AWS Bedrock with workspace files (AGENTS.md, SOUL.md, USER.md, TOOLS.md, IDENTITY.md), persistent sessions stored as JSONL, and a full tool system.

๐Ÿ’กEverything described in these docs reflects real, working infrastructure โ€” not vaporware. SkyKoi is a production platform built on proven agent technology.