WeWake AgentStudio

A low-code/no-code platform for building, sharing, and deploying production-ready AI agents on AWS.

🚀 Overview

WeWake AgentStudio is a visual platform that turns AI agents into reusable assets. Build single-agent and multi-agent workflows using a visual canvas, configure prompts, tools, memory, and guardrails, then deploy with one click to Amazon Bedrock AgentCore or AWS Lambda.

Key Features

Visual Agent Builder: Step-by-step wizard for agent configuration
Multi-Agent Workflows: Support for hierarchical, swarm, and graph patterns
Marketplace: Public sharing of agents, tools, and workflows
Library: Private storage and organization
Code Generation: Transform configurations into Strands SDK code
AWS Deployment: One-click deployment to Lambda/AgentCore

📁 Project Structure

wewake-agentstudio/
├── backend/                    # Python Flask backend
│   ├── src/
│   │   ├── api/               # API routes
│   │   ├── services/          # Business logic
│   │   └── codegen/           # Code generation engine
│   ├── app.py                 # Flask application
│   └── requirements.txt       # Python dependencies
│
├── frontend/                   # React frontend
│   ├── src/
│   │   ├── components/        # React components
│   │   ├── services/          # API services
│   │   └── pages/             # Page components
│   ├── package.json           # Node dependencies
│   └── public/                # Static assets
│
├── .kiro/                      # Kiro AI development system
│   ├── specs/                 # Feature specifications (107 specs)
│   ├── hooks/                 # Development automation hooks
│   ├── steering/              # Coding standards and guidelines
│   ├── INDEX.md               # Quick navigation guide
│   ├── IMPLEMENTATION_GUIDE.md # Development reference
│   └── COMPLETE_SUMMARY.md    # Executive summary
│
├── scripts/                    # Utility scripts
│   ├── deployment/            # Deployment scripts
│   ├── utilities/             # Helper scripts
│   └── testing/               # Test scripts
│
├── data/                       # Data exports and samples
├── logs/                       # Application logs
├── specs/                      # Original specification docs
├── .gitignore                 # Git ignore rules
├── env.example                # Environment template
└── README.md                  # This file

🛠️ Technology Stack

Backend

Language: Python 3.11
Framework: Flask 3.0
AWS SDK: boto3
Database: DynamoDB
Storage: S3

Frontend

Language: JavaScript (ES6+)
Framework: React 18
Router: React Router 6
Styling: Tailwind CSS
Editor: Monaco Editor

AWS Services

AI/ML: Amazon Bedrock (Claude models), AgentCore
Compute: AWS Lambda
Storage: DynamoDB, S3
API: API Gateway
Monitoring: CloudWatch

AI Framework

Primary: Strands Agents SDK
Models: Claude 3.5 Sonnet, Claude 3 Haiku
Tools: MCP (Model Context Protocol)

🚀 Quick Start

Prerequisites

Python 3.11+
Node.js 18+
AWS Account with configured credentials
AWS CLI installed

Backend Setup

cd backend

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp ../.env.example .env
# Edit .env with your AWS credentials

# Create DynamoDB tables
python deploy_tables.py create

# Start backend server
python app.py

Backend runs on: http://localhost:5001

Frontend Setup

cd frontend

# Install dependencies
npm install

# Configure environment
echo "REACT_APP_API_URL=http://localhost:5001" > .env

# Start frontend
npm start

Frontend runs on: http://localhost:3000

Using Quick Start Scripts

# Setup and start both backend and frontend
./scripts/deployment/setup_mvp.sh

# Start services
./scripts/deployment/start_mvp.sh

# Restart services
./scripts/deployment/restart_mvp.sh

📚 Documentation

Core Documentation

Implementation Guide - Central development reference
Complete Summary - Executive summary
Index - Quick navigation to all resources
Spec Index - All 107 feature specifications

Development Guidelines

API Documentation

Backend API: See backend/README.md
Code Generation: See backend/src/codegen/README.md

🔧 Development

Running Tests

# Backend tests
cd backend
pytest

# Frontend tests
cd frontend
npm test

Code Quality

# Python linting
cd backend
flake8 src/
pylint src/

# JavaScript linting
cd frontend
npm run lint

Development Hooks

The project includes automated development hooks in .kiro/hooks/:

Auto-run tests on file save
Environment setup validation
Documentation spell-check
API documentation generation

See .kiro/hooks/ for all available hooks.

🚢 Deployment

Development Deployment

./scripts/deployment/deploy.sh

Production Deployment

./scripts/deployment/deploy_ec2_production.sh

See deployment guides in .kiro/specs/ for detailed instructions.

📊 Database Schema

DynamoDB Tables

dev-agentic-workflows

Stores user workflows and agent configurations
Partition Key: user_id, Sort Key: workflow_id

user-leads

Stores user information
Partition Key: user_id, GSI: email-index

marketplace-items

Stores published agents, tools, and workflows
Partition Key: item_id, GSI: type-index, category-index

user_library

Stores private user items
Partition Key: user_id, Sort Key: item_id

🔐 Environment Variables

Backend (.env)

AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
FLASK_ENV=development
FLASK_DEBUG=True
SECRET_KEY=your_secret_key
DATABASE_ENV=development
CORS_ORIGINS=http://localhost:3000
API_URL=http://localhost:5001

Frontend (.env)

REACT_APP_API_URL=http://localhost:5001

See env.example for complete template.

🤝 Contributing

Development Workflow

Check .kiro/specs/SPEC_INDEX.md for feature specifications
Review relevant coding standards in .kiro/steering/
Follow the spec → design → tasks workflow
Write comprehensive tests (unit + property-based)
Update documentation

Code Standards

Follow PEP 8 for Python
Use ESLint for JavaScript
Include type hints/PropTypes
Write comprehensive tests
Document all functions

📈 Project Status

Completed Features

✅ User identification (session-based)
✅ Workflow CRUD operations
✅ Marketplace publishing and discovery
✅ Library management
✅ Code generation engine
✅ Agent builder UI (partial)

In Progress

🚧 Complete agent builder wizard
🚧 Multi-agent workflow execution
🚧 AWS deployment integration
🚧 Testing sandbox

Planned

📋 Advanced features (memory, guardrails, observability)
📋 Complete UX polish
📋 Production deployment
📋 Performance optimization

🐛 Troubleshooting

Common Issues

Backend won't start

Check AWS credentials in .env
Verify DynamoDB tables exist
Check Python version (3.11+)

Frontend won't start

Check node_modules installed
Verify .env has correct API URL
Check Node version (18+)

CORS errors

Verify backend CORS_ORIGINS includes frontend URL
Check API_URL in frontend .env

See troubleshooting guides in .kiro/specs/ for detailed solutions.

📞 Support

Documentation: See .kiro/ directory
Issues: GitHub Issues
AWS Support: https://console.aws.amazon.com/support/

📄 License

🙏 Acknowledgments

Strands Agents: https://strandsagents.com/
Amazon Bedrock: https://aws.amazon.com/bedrock/
AgentCore: https://aws.amazon.com/bedrock/agentcore/

Version: 1.0.0
Last Updated: March 13, 2026
Status: Active Development

Name		Name	Last commit message	Last commit date
.kiro		.kiro
backend		backend
data		data
frontend		frontend
scripts		scripts
.gitignore		.gitignore
PROJECT_STRUCTURE.md		PROJECT_STRUCTURE.md
README.md		README.md
env.example		env.example
requirements.txt		requirements.txt

Latest commit

History

Folders and files

Repository files navigation