Strands Agents로 빅마우스 빌리 베스를 실시간 음성 AI 비서로 만들기

🐟 BillAI Bass Builder Guide Powered by Strands Agents Bidirectional Streaming + Amazon Nova 2 Sonic billai-bass-demo-strands.mp4 Turn a Big Mouth Billy Bass into a real-time voice assistant: you talk, the fish talks back — head swiveling, mouth lip-syncing to its own voice, tail flapping for emphasis. The fish runs a Strands Agents bidirectional streaming agent ( BidiAgent ) on a Raspberry Pi 5, streaming live audio to and from Amazon Nova 2 Sonic on Amazon Bedrock. No robotics experience needed. No prior soldering experience needed. The person this guide is based on had never plugged in a Raspberry Pi before and got a talking fish in a weekend. Inspired by the excellent billy-b-assistant project, rebuilt on Strands. What's in this repo File What it is README.md This guide — start here, work top to bottom billy.py The final working Python — the talking fish motors.py Standalone motor test rig — run this before billy.py to verify wiring asoundrc.example The ALSA config that pins the USB mic + speaker as defaults requirements-frozen.txt Exact dependency versions from a known-good Pi build — pip install -r for guaranteed-working setup iot-identity/ Optional production-grade credentials: CloudFormation template + walkthrough for X.509-cert auth instead of access keys How to use this with an AI assistant Paste this README into Claude (or another AI assistant) and say: "I'm building this. Walk me through it one step at a time — wait for me to confirm each step before giving the next." That's the way it was built; that's the way it builds best. See the Build this WITH an AI Assistant section below for what to send when stuck. 🤝 Build this WITH an AI Assistant This project was created with help from Claude Code and you can use any AI assistant to help you get through. Paste this entire guide into your AI and say: "I'm building this. Walk me through it one step at a time — wait for me to confirm each step before giving the next." Your AI will pace the build to you, debug your exact error messages, and adapt when your hardware differs slightly from this guide. Things AI is great at during this build: Paste your exact error message — the scary 50-line Python traceback usually has one meaningful line, and AI will find it. Send photos — stuck identifying a motor? Can't tell which pin is which? Photograph it and ask. (In Claude Code on a Mac: drop the image file into the terminal, or say "look at ~/Downloads/IMG_1234.jpg".) Say "I know nothing about X" — AI will back up and explain. There are no dumb questions. Ask before cutting/soldering anything you're unsure about. If you hit something this guide doesn't cover, that's not a failure of you. It's probably a gap in the guide. AI + your error message will get you through. 🛒 Shopping list If you got a kit: you have everything in this table already. Building from scratch: this is the original Amazon order (~$240 total, January 2026 prices). Item What it's for ~Price Big Mouth Billy Bass (current "Gemmy" version) The fish. The modern version has 2 motors, which this guide assumes $30 Raspberry Pi 5, 8GB The brain. 4GB would also work $80 27W USB-C PD power supply (official Pi or RasTech GaN) Don't substitute a phone charger — the Pi limits power to USB ports without a proper supply $15 Official Raspberry Pi 5 Active Cooler Heatsink + fan. The Pi runs hot without it $10 MicroSD card, 64GB (e.g. Transcend USD340, any name brand) The Pi's hard drive $12 USB mini speaker (e.g. HONKYOB) Billy's voice $15 USB gooseneck mini microphone (e.g. CGS-M1) Billy's ears $13 MX1508 dual H-bridge motor driver, 5-pack (e.g. Aideepen, sold as "L298N replacement") Lets the Pi safely drive the motors. You need 1; the spares forgive mistakes $9 DuPont jumper wire kit, 120pc male/female mix (e.g. ELEGOO) Connects driver board to Pi. You'll use ~6 female-to-female $7 Soldering iron kit, 60W adjustable with tips + solder 10 solder joints total. Cheapest kit is fine $20 Flush cutters (e.g. KATA 2-pack) Snipping and stripping wires $9 JST XH connector kit Optional — handy for tidy splices, but the build works without it $9 Also needed, not in the kit: A personal computer (Mac/Windows/Linux) to flash the SD card — ⚠️ corporate laptops often block USB storage; use a home machine A way to plug a microSD into that computer (most cards include an SD adapter) An AWS account (personal, not your employer's) with a payment method — you'll create a locked-down, fish-only IAM user in the prerequisites below Tape (electrical ideally, Scotch works), a small Phillips screwdriver Home WiFi that both your computer and the Pi can join ✅ Prerequisites (do these before build day) 1. AWS / Amazon Bedrock setup (least privilege — do it right) 💸 No AWS account yet? The free tier covers this project. New AWS accounts get $100 in credits (up to $200 with activities), and Amazon Bedrock is usable on the free plan with credits applied to Nova usage. Voice chat is cheap — roughly a penny per few minutes of conversation — so credits buy on the order of 100+ hours of fish banter. Two free-plan caveats: Brand-new accounts sometimes start with Bedrock invocation quotas set to zero (no payment history yet). If model access is granted but every call fails with ValidationException: Operation not allowed , that's the quota — file a (free) AWS support case asking for Nova Sonic on-demand quota, or upgrade to the paid plan (your remaining credits carry over). Free-plan accounts auto-close after 6 months (or when credits run out). Fine for a demo fish; if Billy's becoming a permanent housemate, upgrade to paid before the deadline — unused credits survive the upgrade. Your AWS keys will live in a plaintext file on a Pi inside a fish. Fish get demoed, lent out, and left on desks; SD cards pop out. So the keys must be able to do exactly one thing : talk to Nova Sonic. If they leak, the worst case is someone chats with a fish on your dime — not someone mining crypto in your account. Step 1 — Enable model access: In the AWS console, switch region to us-east-1 (N. Virginia) — Nova Sonic lives there. Go to Amazon Bedrock → Model access and request access to Nova 2 Sonic ( amazon.nova-2-sonic-v1:0 ). Usually instant. (Not v1 — original Nova Sonic hits end-of-life September 2026.) Step 2 — Create a dedicated IAM user: Console → IAM → Users → Create user . Name it something honest like billy-bass . Do NOT check "Provide user access to the AWS Management Console" — this user is a robot fish; it never logs into anything. On the permissions screen, choose "Attach policies directly" but don't select any of the AWS-managed policies (no AmazonBedrockFullAccess — that grants far more than the fish needs). Just click through and create the user with zero permissions. Step 3 — Attach a policy that allows only Nova Sonic: Open the new user → Permissions → Add permissions → Create inline policy → JSON tab. Paste: { "Version" : " 2012-10-17 " , "Statement" : [ { "Sid" : " BillyTalksToNovaSonicOnly " , "Effect" : " Allow " , "Action" : " bedrock:InvokeModelWithBidirectionalStream " , "Resource" : " arn:aws:bedrock:us-east-1::foundation-model/amazon.nova-2-sonic-v1:0 " } ] } Name it billy-nova-sonic-only , save. That's one action on one model in one region. No S3, no EC2, no other Bedrock models, no ability to see or change anything else in your account. (If you later give Billy tools that touch AWS — say, reading a DynamoDB table — add that specific permission to this policy then, not broad access now.) Step 4 — Create the access key: User → Security credentials → Create access key → choose "Application running outside AWS". Copy the access key ID + secret somewhere safe — the secret is shown exactly once. These go on the Pi later (§1.6). Step 5 — Optional but smart: set a billing alarm. Console → Billing → Budgets → create a $10/month budget with an email alert. Casual Nova Sonic chat costs cents; the alarm is there so a stuck always-listening fish (or leaked key) can't surprise you. If the keys