Skip to content

Create an AI-powered doorbell with no wires, transformers, or installation. All you need is TiDB and AWS!

License

Notifications You must be signed in to change notification settings

kevinl95/TitaniumDoorman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TitaniumDoorman

TitaniumDoorman Logo

Lint CloudFormation Template

Hardware-less doorbell for the TiDB AgentX Hackathon. Visitors can scan a QR code → interact with an AI agent → resident gets notified via a text on their phone! No transformer, batteries, wires, or chime required. This makes it perfect for apartments, condos, or older homes. Best of all, it deploys with a single click with no coding or cloud experience required!

Quick Deploy

Deploy to AWS

Prerequisites:

  • AWS Account with permissions for Lambda, API Gateway, SNS, S3, Secrets Manager, Bedrock
  • Enable Bedrock model access: Go to AWS Console → Bedrock → Model access → Request access for "Titan Text G1 - Express"
  • TiDB Serverless cluster (get free at tidbcloud.com)

Setup Steps:

  1. Create TiDB Serverless cluster at tidbcloud.com
  2. Click "Connect" → "Generate Password" → copy the connection string, which is in the tab next to the Parameters on the connection modal
  3. Click "Deploy to AWS" button above
  4. Enter your TiDB connection string and notification email address
  5. Deploy the stack (takes ~3 minutes)
  6. Check your email and confirm the SNS subscription (click the confirmation link)
  7. Open the "QRCodeUrl" from stack outputs
  8. Print the QR code page and post by your door!
  9. Done! Visitors can now scan and interact with your virtual doorman

How It Works

TitaniumDoorman Architecture

Multi-Step Agentic AI Workflow:

  1. Data Ingestion → Visitor messages stored in TiDB with session tracking
  2. Historical Context → Agent checks previous visits for returning visitor detection
  3. AI Classification → Amazon Bedrock (Titan Text Express) analyzes message context
  4. AI Response Generation → Personalized responses based on visitor history
  5. External Actions → Email notifications sent to resident with visit context

Intelligence Features:

  • Recognizes returning visitors and personalizes responses
  • Tracks historical visit patterns in TiDB
  • Provides visit context to residents via email
  • Fallback classification ensures reliability

Architecture

  • S3 Static Website - Visitor interface and QR code generation
  • API Gateway - Public endpoints for visitor interactions
  • Lambda Functions - Session management and AI agent orchestration
  • TiDB Serverless - Stores visits and transcripts with historical search
  • AWS Bedrock - AI for visitor intent classification and response generation
  • SNS - Email notifications to residents
  • Secrets Manager - Secure TiDB credential storage

About

Create an AI-powered doorbell with no wires, transformers, or installation. All you need is TiDB and AWS!

Topics

Resources

License

Stars

Watchers

Forks