https://github.com/psd401/aistudio
Democratize AI access in K-12 education with multi-model platform deployed on your infrastructure
https://github.com/psd401/aistudio
ai-platform artificial-intelligence aws aws-cdk claude education-technology gemini k12-education nextjs openai self-hosted
Last synced: 3 months ago
JSON representation
Democratize AI access in K-12 education with multi-model platform deployed on your infrastructure
- Host: GitHub
- URL: https://github.com/psd401/aistudio
- Owner: psd401
- License: mit
- Created: 2025-01-12T06:31:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-31T15:14:15.000Z (3 months ago)
- Last Synced: 2026-03-31T17:29:54.568Z (3 months ago)
- Topics: ai-platform, artificial-intelligence, aws, aws-cdk, claude, education-technology, gemini, k12-education, nextjs, openai, self-hosted
- Language: TypeScript
- Homepage: https://psd401.ai/aistudio
- Size: 87.8 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# AI Studio
[](https://opensource.org/licenses/MIT)
[](https://nextjs.org/)
[](https://github.com/psd401/aistudio/releases)
> **Bring frontier AI to K-12 education—securely, affordably, and responsibly.**
AI Studio is an open-source platform that provides K-12 educators and students with access to cutting-edge generative AI models at **90% lower cost** than individual licenses. Built with privacy-first architecture and deployed within district infrastructure, it democratizes access to AI tools that were previously cost-prohibitive for schools.
## 🎬 See It In Action
**Learn more**: [https://psd401.ai/aistudio](https://psd401.ai/aistudio)
AI Studio is a **self-hosted platform** deployed within your district infrastructure for security and compliance. Screenshots and feature overview available on our project page.
**Ready to deploy?** See the complete [Deployment Guide](./docs/DEPLOYMENT.md)
## 🎯 Why AI Studio?
### The Problem
- **Cost Barriers**: Individual AI subscriptions cost $20-200/month per user—unsustainable for districts
- **Access Inequality**: Students lack exposure to frontier models used in higher education and industry
- **Data Privacy**: Third-party AI services raise concerns about student data protection
- **Content Safety**: Consumer AI tools lack appropriate safeguards for K-12 environments
- **Complexity**: Creating custom AI assistants requires coding expertise
### The Solution
AI Studio eliminates these barriers by:
- **90% Cost Reduction**: Secure API architecture replaces expensive per-seat licenses
- **Multi-Model Access**: Real-time switching between GPT-5, Claude Opus, and Google Gemini
- **District-Level Security**: All data processed within your secure servers—nothing leaves your environment
- **K-12 Content Safety**: Automatic content filtering and PII protection across all AI interactions
- **No-Code Customization**: Design custom AI assistants using visual prompt chains
- **Open Source**: MIT-licensed, fully self-hostable on your infrastructure
## ✨ Key Features
### For Educators & Students
- 🤖 **Nexus Chat** - Conversational AI with multiple frontier models
- Real-time streaming responses
- Conversation history and organization
- Model comparison side-by-side
- 🏗️ **Assistant Architect** - No-code custom AI assistant builder
- Visual prompt chain designer
- Variable substitution between prompts
- Knowledge repository integration
- Scheduled execution
- 📚 **Knowledge Repositories** - Upload and search documents
- PDF, DOCX, TXT support with OCR
- Vector embeddings for semantic search
- Context-aware AI responses
- 📊 **Model Compare** - Side-by-side model evaluation
- Compare GPT-5, Claude Opus, Gemini responses
- Token usage and cost analysis
- Performance metrics
### For Administrators
- 🔒 **Enterprise Security**
- AWS Cognito authentication with Google SSO
- Role-based access control (RBAC)
- Tool-level permissions
- Audit logging
- 🛡️ **K-12 Content Safety** - Purpose-built for educational environments
- **Content Filtering**: Blocks inappropriate content (violence, hate speech, sexual content) in both inputs and AI responses using Amazon Bedrock Guardrails
- **PII Protection**: Automatically detects and tokenizes student personal information (names, emails, phone numbers) before sending to AI providers
- **Compliance Ready**: Helps meet COPPA, FERPA, and CIPA requirements
- **Real-time Alerts**: SNS notifications for safety violations
- **Zero Configuration**: Works automatically across all AI providers
- See [K-12 Content Safety Documentation](./docs/features/k12-content-safety.md) for details
- 💰 **Cost Control**
- Transparent usage tracking
- Per-user quotas and rate limiting
- Provider cost comparison
- Auto-pause dev environments
- 📈 **Monitoring & Observability**
- CloudWatch dashboards
- OpenTelemetry tracing
- Circuit breaker for AI provider failures
- Performance metrics
### Integration Platform
- 🔌 **API v1** - REST API for external integrations
- Authenticated endpoints for assistants, decisions, and chat
- API key management (`sk-` prefix tokens)
- Rate limiting (60 req/min default)
- OpenAPI specification at `docs/API/v1/openapi.yaml`
- 🔐 **OAuth2/OIDC Provider** - JWT-based auth for external apps
- Authorization Code Flow with PKCE
- Access tokens (15min), refresh tokens (24hr), ID tokens
- Granular scopes for API, MCP, and OIDC
- Admin UI for client registration at `/admin/oauth-clients`
- 🤖 **MCP Server** - Model Context Protocol for AI tool integrations
- 5 tools: search decisions, capture decisions, list assistants, execute assistants, get context
- Works with Claude Code, Cursor, and custom MCP clients
- Authenticated via API key or OAuth token
- 🧭 **Decision Framework** - Structured decision capture & graph
- Capture decisions with context, alternatives, and outcomes
- Graph-based decision relationships
- Search and retrieve past decisions for organizational knowledge
## 🏗️ Architecture
Built on AWS with production-ready infrastructure:
- **Frontend**: Next.js 16 (App Router) with React 19 Server Components
- **Backend**: ECS Fargate containers with Application Load Balancer
- **Database**: Aurora Serverless v2 (PostgreSQL) with Drizzle ORM and postgres.js driver
- **Authentication**: AWS Cognito + NextAuth v5
- **AI Providers**: OpenAI (GPT-5), Anthropic (Claude), Google (Gemini), AWS Bedrock via AI SDK v6
- **Infrastructure**: AWS CDK (TypeScript) following Well-Architected Framework
- **Streaming**: Server-Sent Events (SSE) over HTTP/2 for real-time responses
See [Architecture Diagrams](./docs/diagrams/README.md) for detailed visualizations.
## 🚀 Quick Start
### Prerequisites
- Node.js 20.x and npm
- AWS CLI configured with appropriate credentials
- AWS CDK CLI (`npm install -g aws-cdk`)
- Docker installed (for building container images)
### Local Development
```bash
# Clone repository
git clone https://github.com/psd401/aistudio.git
cd aistudio
# Install dependencies
npm install
# Copy environment variables
cp .env.example .env.local
# Edit .env.local with your configuration
# Start local PostgreSQL and dev server
npm run db:up # Start PostgreSQL via Docker
npm run db:seed # Create test users (first time)
npm run dev:local # Start Next.js with local database
```
Open [http://localhost:3000](http://localhost:3000) to see the application.
### Deployment to AWS
```bash
# Bootstrap CDK (one-time)
cd infra
npx cdk bootstrap aws://ACCOUNT-ID/REGION
# Deploy infrastructure stacks
npx cdk deploy AIStudio-DatabaseStack-Dev
npx cdk deploy AIStudio-AuthStack-Dev
npx cdk deploy AIStudio-StorageStack-Dev
npx cdk deploy AIStudio-DocumentProcessingStack-Dev
npx cdk deploy AIStudio-GuardrailsStack-Dev
npx cdk deploy AIStudio-FrontendStack-Dev
# Or deploy all at once
npx cdk deploy --all
```
See [Deployment Guide](./docs/DEPLOYMENT.md) for detailed instructions.
## 📊 Cost Comparison
### Traditional Approach (Per-Seat Licenses)
```
100 users × $20/month (ChatGPT Plus) = $2,000/month = $24,000/year
```
### AI Studio (API-Based)
```
100 users × average 50,000 tokens/day
= 1.5M tokens/day × 30 days = 45M tokens/month
= $450/month (GPT-5) + $200 infrastructure = $650/month = $7,800/year
Savings: $16,200/year (67% reduction)
```
With mixed usage (Gemini + GPT-4 mini), costs drop to ~$200/month (**90% savings**).
## 🛠️ Tech Stack
### Frontend
- Next.js 16 with App Router
- React 19 with Server Components
- Shadcn UI component library
- Tailwind CSS for styling
- Vercel AI SDK v6 for streaming
### Backend
- ECS Fargate for container hosting
- Aurora Serverless v2 (PostgreSQL)
- Drizzle ORM with postgres.js driver
- AWS Lambda for async processing
- S3 for document storage
- AWS Textract for OCR
### Infrastructure
- AWS CDK for Infrastructure as Code
- VPC with multi-AZ subnets
- Application Load Balancer with HTTP/2
- CloudWatch + ADOT for observability
- Secrets Manager for credentials
- Cognito for authentication
## 📚 Documentation
### Core Documentation
- [Architecture Overview](./docs/ARCHITECTURE.md) - Complete system architecture
- [Deployment Guide](./docs/DEPLOYMENT.md) - Step-by-step deployment
- [API Reference](./docs/API_REFERENCE.md) - REST endpoints and server actions
- [Error Reference](./docs/ERROR_REFERENCE.md) - Error codes and debugging
- [Troubleshooting](./docs/TROUBLESHOOTING.md) - Common issues and solutions
### Infrastructure
- [CDK Infrastructure](./infra/README.md) - AWS CDK stack details
- [VPC Network Topology](./docs/diagrams/02-vpc-network-topology.md)
- [AWS Service Architecture](./docs/diagrams/03-aws-service-architecture.md)
### Visual Architecture
- [All Diagrams (9 total)](./docs/diagrams/README.md) - 10,000+ lines of visual documentation
- [Database ERD](./docs/diagrams/04-database-erd.md) - 54 PostgreSQL tables
- [Authentication Flow](./docs/diagrams/05-authentication-flow.md) - OAuth 2.0 flow
- [Streaming Architecture](./docs/diagrams/09-streaming-architecture.md) - SSE implementation
### Integration
- [API v1 Quickstart](./docs/guides/api-quickstart.md) - Getting started with the REST API
- [OAuth2 Integration](./docs/guides/oauth-integration.md) - Authenticating external apps
- [MCP Integration](./docs/guides/mcp-integration.md) - Connecting AI tools via MCP
### Development
- [Developer Guide](./DEVELOPER_GUIDE.md) - Development setup and workflow
- [Library Documentation](./lib/README.md) - Core utilities and patterns
- [CLAUDE.md](./CLAUDE.md) - AI assistant development guidelines
## 🧪 Testing
```bash
# Run test suite
npm test
# Run tests in watch mode
npm run test:watch
# Run linting
npm run lint
# Run type checking
npm run typecheck
```
## 🤝 Contributing
We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
## 📄 License
MIT License - see [LICENSE](./LICENSE) file for details.
## 🙏 Acknowledgments
AI Studio was developed by Peninsula School District (PSD401) to bring world-class AI tools to K-12 education. Built with:
- [Next.js](https://nextjs.org/) - React framework
- [Vercel AI SDK](https://sdk.vercel.ai/) - AI streaming infrastructure
- [AWS CDK](https://aws.amazon.com/cdk/) - Infrastructure as Code
- [Shadcn UI](https://ui.shadcn.com/) - UI component library
## 🔗 Links
- **Website**: [psd401.ai/aistudio](https://psd401.ai/aistudio)
- **Documentation**: [docs/](./docs/)
- **Issues**: [GitHub Issues](https://github.com/psd401/aistudio/issues)
- **Discussions**: [GitHub Discussions](https://github.com/psd401/aistudio/discussions)
---
**Built with ❤️ for K-12 education**
*Making frontier AI accessible, secure, and affordable for every student.*