-
-
Nova Architect Dashboard — "Powered by Amazon Nova: Nova 2 Lite + Nova Sonic + Nova Act + Nova Pro."
-
Nova proposes an architecture and asks for approval before provisioning real AWS infrastructure.
-
Nova Act autonomously navigates the AWS Console to create infrastructure in real time.
-
Nova Act successfully provisioning an S3 bucket inside the AWS Console without manual intervention.
-
Nova Act reasoning and execution logs showing step-by-step decision making during infrastructure deployment.
-
Infrastructure successfully deployed — S3, Lambda, and API Gateway created automatically from a single prompt.
-
One-click CloudFormation export — Nova converts the generated architecture into production-ready AWS CloudFormation YAML
-
System Architecture
-
Install Nova Architect with a single command and start building infrastructure instantly.
Quick Overview
Problem: Configuring AWS infrastructure is complex and time-consuming for developers.
Solution: Nova Architect is an AI cloud engineer that converts plain-English application descriptions into real AWS infrastructure by autonomously navigating the AWS Console.
Key Innovation: Instead of generating templates, Nova Act directly controls the AWS Console and provisions infrastructure in a real account.
Pipeline:
Plain English → Nova 2 Lite (architecture reasoning) → Nova 2 Sonic (voice explanation) → Nova Act (autonomous console execution) → AWS resources.
Result: Production AWS services deployed automatically from a single sentence.
Inspiration
Every developer knows the feeling. You have an idea — a photo sharing app, a real-time chat system, an e-commerce backend. You open the AWS Console. Two hours later you're reading documentation about NAT Gateways, IAM trust policies, and VPC CIDR blocks. You haven't written a single line of product code yet.
AWS has 200+ services. The average developer actively uses 6. Not because they don't need the others — because the learning curve to configure them is enormous. A junior developer staring at the AWS Console for the first time faces the same overwhelming wall that has stopped thousands of great ideas from ever getting built.
We asked a simple question: what if you could just describe what you want to build, and something built it for you? Not generated a template. Not produced YAML for you to copy-paste. Actually built it — clicking the same buttons you would click, in your real AWS account, while you got coffee.
That question became Nova Architect.
Real-Time Architecture Generation
What it does
Nova Architect is an autonomous AI cloud engineer that designs and deploys AWS infrastructure directly in your console. You describe your application in plain English. It designs, explains, and builds your AWS infrastructure — live, in your real AWS account — using a coordinated pipeline of all four Amazon Nova models.
Here is what happens when you type a single sentence:
DESIGN — Nova 2 Lite receives your requirement and reasons over it like a senior solutions architect. It designs the optimal serverless AWS architecture, selects the right services, determines dependency order, generates a visual SVG flow diagram, and estimates your monthly cost. All in under 10 seconds.
PRESENT — Nova 2 Sonic speaks the architecture aloud in a natural voice: "I've designed a 4-service serverless architecture: S3 for image storage, Lambda for processing, DynamoDB for metadata, and API Gateway for your REST endpoints. Estimated cost: $4.20 per month. Shall I build this?" You can approve by clicking or by speaking.
BUILD — Nova Act opens a real Chromium browser, navigates to the AWS Console, and physically creates every service by clicking buttons and filling forms — exactly as a human developer would. Live screenshots stream back to your dashboard in real time so you can watch every click.
VERIFY — Each service card turns green as it completes. When all services are built, the real AWS resources exist in your account. You can open the AWS Console and see them.
System Architecture
Nova Architect is powered by a multi-model Amazon Nova pipeline.
User Prompt → Nova 2 Lite (Architecture reasoning) → Nova 2 Sonic (Voice explanation) → Nova Act (Autonomous AWS Console execution) → AWS Infrastructure (S3, Lambda, DynamoDB, API Gateway)
The system runs on a FastAPI backend with WebSocket streaming for live execution logs and screenshot updates.
Nova Architect also accepts hand-drawn architecture sketches via Nova Pro — point your phone at a whiteboard, upload the photo, and Nova Pro extracts the services and feeds them into the pipeline.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔴 TRY THE LIVE DEMO — NO INSTALL REQUIRED ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Visit http://54.226.19.180:8000 in your browser. Type any application requirement. Watch Nova 2 Lite design a real AWS architecture for you in real time. No account. No setup. No install.
Architecture design is live (real Bedrock API calls). Build simulation active (Nova Act automation requires local install).
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚡ INSTALL NOVA ARCHITECT LOCALLY ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
For full Nova Act automation — watch the cursor move and build real AWS infrastructure live — install Nova Architect on your machine.
REQUIREMENTS Before installing, you need:
Python 3.11 or higher Download from python.org — make sure to check "Add to PATH" on Windows
An AWS Account with IAM credentials AWS Console → IAM → Users → Your User → Security credentials → Create access key You need an Access Key ID and Secret Access Key Your IAM user needs permissions for: S3, Lambda, DynamoDB, API Gateway, Bedrock, Polly — or attach AdministratorAccess for personal use
Amazon Bedrock Nova model access AWS Console → Bedrock → Model access → Request access for: Amazon Nova Lite, Amazon Nova Pro, Amazon Nova Sonic
A Nova Act API key (free) Visit nova.amazon.com/act → Developer Tools → Create API key
STEP 1 — Create a virtual environment We strongly recommend installing Nova Architect in a virtual environment to avoid dependency conflicts with other Python packages.
On Mac/Linux: python3 -m venv nova-env source nova-env/bin/activate
On Windows (PowerShell): python -m venv nova-env nova-env\Scripts\Activate.ps1
You should see (nova-env) at the start of your terminal prompt. This means the virtual environment is active.
STEP 2 — Install Nova Architect With your virtual environment active, run:
pip install nova-architect==2.9.2
This installs Nova Architect and all dependencies including FastAPI, Playwright, boto3, and the Rich terminal UI. Takes 2-3 minutes.
STEP 3 — Run the setup wizard nova-architect setup
This launches an interactive 3-step wizard:
Step 1 of 3 — AWS Credentials Paste your AWS Access Key ID and Secret Access Key. Nova Architect checks them against Bedrock immediately. Your credentials are saved to ~/.nova-architect/config.json on your local machine. They are never sent anywhere else.
Step 2 of 3 — Nova Act API Key Paste your Nova Act API key from nova.amazon.com/act.
Step 3 of 3 — Browser Setup Installs Chromium (~170MB) for Nova Act to use. This is the browser Nova Act will control to build your AWS infrastructure.
STEP 4 — Start the dashboard nova-architect start
Your browser opens automatically at http://localhost:8000. Type a requirement. Hit Design & Build. Watch Nova Act work.
STEP 5 — Verify everything is working nova-architect doctor
This runs a full health check and prints a table:
✓ Python version 3.11 OK ✓ AWS credentials ...XXXX OK ✓ Nova Act SDK installed OK ✓ Nova Act API key set OK ✓ Playwright installed OK ✓ Chromium installed OK ✓ Config file found OK ✓ AWS Region us-east-1 OK
All green means you're ready to build.
ADDITIONAL CLI COMMANDS
nova-architect start --headless # Nova Act runs without visible browser nova-architect start --demo # Demo mode, no real AWS resources created nova-architect start --port 9000 # Use a custom port nova-architect reset # Delete all nova-architect-* AWS resources nova-architect upgrade # Update to the latest version nova-architect version # Show current version
TROUBLESHOOTING
"Bedrock access denied" → Enable Nova models in AWS Console → Bedrock → Model access
"Nova Act authentication failed"
→ Regenerate your key at nova.amazon.com/act → Developer Tools
"Chromium not found" → Run: python -m playwright install chromium
"Bucket already exists" → This is handled automatically in v2.0 — resource names include unique suffixes and existing resources are treated as success
Run nova-architect doctor to diagnose any issue automatically.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📦 SOURCE CODE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
github.com/Shyamistic/Nova-Architect-cli
Because building on AWS should feel like talking to your best engineer.
Automated Infrastructure Design
.gif)
How we built it
Nova Architect uses all four Amazon Nova models in a coordinated pipeline, each handling a distinct role that plays to its strengths.
NOVA 2 LITE — The Architecture Brain We engineered a detailed system prompt that instructs Nova 2 Lite to think like a senior AWS solutions architect. It outputs structured JSON containing the services list (in dependency order), a diagram_spec for visual rendering, cost estimates, rationale, and configuration values for each service. We added deduplication logic, unique resource name suffixes to prevent collisions, and CloudFormation YAML export capability.
NOVA ACT — The Builder This was the hardest and most exciting part. Nova Act controls a real Chromium browser via Playwright. We wrote specific natural-language handlers for each AWS service — S3, Lambda, DynamoDB, API Gateway, SQS, SNS, Cognito, EventBridge, and IAM. Each handler instructs Nova Act exactly how to navigate that service's console UI. We implemented 2-attempt retry logic, graceful handling of "already exists" states, pre-build IAM permission preflight checks, and real-time screenshot streaming back to the dashboard via WebSocket.
NOVA 2 SONIC — The Voice Nova Sonic handles both directions of the voice interface. For text-to-speech we use Amazon Polly Neural (Ruth voice, SSML) to speak the architecture aloud during the approval flow. For speech-to-text we integrated Amazon Transcribe so users can speak their requirements directly into the microphone — the browser records via MediaRecorder API, sends the audio to the backend, Transcribe returns the text, and the design pipeline triggers automatically.
NOVA PRO — The Eyes Nova Pro's multimodal capability reads uploaded photos of hand-drawn architecture diagrams and whiteboard sketches. It extracts service names, relationships, and data flows, then passes a structured vision result to Nova 2 Lite which converts it into a complete build plan.
THE STACK Backend: FastAPI + WebSocket for real-time streaming. SQLite for build history persistence. Pydantic-settings for configuration. Rate limiting, structured JSON logging, and graceful shutdown handlers for production reliability.
Frontend: Single-file vanilla JS dashboard with a 3-panel layout — Intelligence (left), Action/browser chrome (center), Audit (right). SVG architecture diagram renderer, live cost counter, CSS confetti, animated pipeline status header showing Nova Lite → Nova Sonic → Nova Act → AWS with real-time status dots.
Distribution: Packaged as a pip-installable Python package with a full CLI — setup wizard, doctor command, reset command, auto-browser-open. Config stored in ~/.nova-architect/ so credentials never live in the project directory.
Deployment: Live demo server on AWS EC2 (free tier) running in demo mode — architecture design is real (Bedrock), build simulation active. Available at http://54.226.19.180:8000 for judges to test without any installation.
Nova Architect CLI Health Check
.png)
nova-architect doctor validates the full environment setup — Python, AWS credentials, Nova Act SDK, Playwright, and Chromium — ensuring everything is ready for autonomous AWS infrastructure deployment.
Key Features
• Natural language → AWS infrastructure
• Autonomous AWS Console execution using Nova Act
• Real-time architecture visualization
• Voice interface powered by Nova Sonic
• Multimodal diagram input via Nova Pro
• Live deployment logs and screenshot streaming
• One-click CloudFormation export
• pip-installable CLI developer tool
Impact
Nova Architect dramatically reduces the barrier to cloud development. Instead of spending hours configuring infrastructure, developers can describe their system in natural language and have production infrastructure built automatically.
This enables: • faster prototyping • lower learning curve for cloud platforms • easier onboarding for new developers • rapid experimentation with AWS architectures
Challenges we ran into
NOVA ACT RELIABILITY The AWS Console is one of the most complex web applications in the world. It changes frequently, has dynamic loading states, and behaves differently across regions and account types. Getting Nova Act to reliably navigate it required extensive prompt engineering for each service handler, retry logic for transient failures, and graceful handling of edge cases like "bucket already exists" errors (which we treat as success — idempotent by design).
NOVA SONIC STREAMING Nova 2 Sonic uses a bidirectional streaming API for real-time voice conversation. The streaming protocol requires careful session management that proved complex to integrate with our async FastAPI WebSocket architecture. We ultimately used Amazon Polly Neural as our TTS layer and Amazon Transcribe for STT, giving us the voice-first UX while maintaining reliability for the demo.
RESOURCE NAME COLLISIONS Running the same requirement twice would fail because S3 bucket names are globally unique. We solved this with a deterministic _uid() suffix using SHA-256 — the same requirement always produces the same resource names (idempotent builds), but different requirements never collide.
PACKAGING FOR DISTRIBUTION Making a complex application with browser automation, AI models, and a web server installable via pip required careful package structure. We needed the backend and frontend to be discoverable at runtime regardless of where pip installed the package — solved by using importlib to find the package directory at startup.
DEPENDENCY CONFLICTS Nova Act, Playwright, and FastAPI all have specific version requirements that conflict when pinned. We moved from exact version pins to minimum version constraints (>=) throughout pyproject.toml, letting pip resolve the best compatible set.
Accomplishments that we're proud of
Watching Nova Act navigate the AWS Console for the first time — the cursor moving by itself, clicking "Create Bucket," typing a name, scrolling to find the button — and then seeing that bucket actually appear in our AWS account was a genuinely extraordinary moment. We built something that has never existed before.
We're proud that Nova Architect ships as a real developer tool, not just a hackathon demo. pip install nova-architect works. The setup wizard runs. The CLI has a doctor command that diagnoses issues, a reset command that cleans up AWS resources, and auto-opens your browser when you start. Someone can install this and have it running in under 5 minutes.
We're proud of using all four Amazon Nova models in a single coordinated pipeline where each model does what it uniquely does best — reasoning, building, speaking, seeing. The pipeline feels like a team of specialized AI agents collaborating, not a single model doing everything.
We're proud of the live demo deployment. Any judge can visit http://54.226.19.180:8000, type a requirement, and watch Nova 2 Lite design a real AWS architecture for them in real time — no installation, no account, no setup. The architecture reasoning is real. The Bedrock API is live. The voice speaks the design aloud.
Finally, we're proud that the core insight is correct: the barrier to building on AWS is not capability — it's configuration. Nova Architect eliminates configuration entirely. That's a real problem solved for real people.
What we learned
The most important thing we learned is that browser automation with AI is genuinely different from traditional automation. Traditional tools like Selenium fail the moment a UI changes. Nova Act understands intent — "click the button that creates a new bucket" — and finds the right element even when the page layout shifts. That resilience is what makes autonomous console navigation possible.
We learned that the hardest part of a multi-model pipeline is not the individual models — it's the handoffs. The architecture JSON that Nova 2 Lite produces has to be structured correctly for Nova Act to consume it. The screenshot that Nova Act captures has to be encoded correctly for WebSocket streaming. Every interface between models required careful design.
We learned that shipping matters. Making Nova Architect installable via pip forced us to think about user experience at every level — the setup wizard, the error messages, the startup time, the browser auto-open. A demo that runs on your laptop is very different from a tool someone else can install and run.
We learned that Amazon Nova models are genuinely capable of production workloads. Nova 2 Lite's architecture reasoning is consistently better than we expected — it makes smart opinionated choices, orders services by dependency correctly, and produces accurate cost estimates. Nova Act's ability to navigate complex, dynamic web UIs reliably is remarkable.
What's next for Nova Architect
MULTI-CLOUD The same architecture — natural language in, browser automation out — works for Azure and Google Cloud. Nova Architect's next milestone is multi-cloud support, letting developers describe once and deploy anywhere.
DESTROY STACK One-click teardown of everything Nova Architect built. Essential for cost management and iterative development.
NOVA ARCHITECT CLOUD A hosted version where developers connect their AWS account via IAM role (no credential sharing), get a web dashboard, and can build infrastructure from any browser without installing anything. $49/month per team. This is the SaaS path.
ENTERPRISE APPROVAL WORKFLOWS For teams: a Nova Architect build generates an architecture plan that goes through a human approval workflow before Nova Act executes. Full audit log. Cost guardrails. Compliance checks.
CONVERSATIONAL ITERATION "Make the Lambda bigger." "Add a Redis cache." "Remove the SQS queue and use EventBridge instead." Multi-turn architecture refinement via Nova Sonic before the build begins.
ACQUISITION PATH Nova Architect is a natural fit inside the AWS Console itself. The vision: every AWS account gets a Nova Architect button. Click it. Describe what you want. Watch it get built.
Because building on AWS should feel like talking to your best engineer.
Log in or sign up for Devpost to join the conversation.