Wed, Oct 08, 25, README Environment Setup V1 - Auto-imported from uconGPT project
-
kor2Unity Project - Environment Setup v1 Branch
- Branch Information
- π― Branch-Specific Features
- π Documentation Available in This Branch
- π§ Quick Start (environment-setup-v1 branch)
- π Port Allocation (environment-setup-v1)
- π Key Achievements in This Branch
- π Branch Context
- π Next Steps for This Branch
- π― Branch-Specific Commands
Auto-imported from:
D:/repos/aiegoo/uconGPT/eng2Fix/kor2fix/README-environment-setup-v1.md
Original filename:README-environment-setup-v1.md
Import date: Wed, Oct 08, 25
kor2Unity Project - Environment Setup v1 Branch
Branch Information
-
Branch:
environment-setup-v1
- Purpose: Dedicated port allocation strategy and Python 3.13 compatibility
- Date: August 7, 2025
- Status: Active development with working FastAPI backend
π― Branch-Specific Features
This branch implements a dedicated port allocation strategy using ports 8200-8299 to avoid conflicts with typical development setups.
π Working Components (Current State)
- FastAPI Backend: Running on port 8201 β
- Health Monitoring: Complete system status API β
- Port Configuration: Full service mapping API β
- Python 3.13: Compatible minimal dependency set β
π Documentation Available in This Branch
Core Documentation
-
docs/DOCKER-SETUP.md
- Docker Desktop installation guide for Windows/WSL -
docs/PORT-ALLOCATION.md
- Complete reference for ports 8200-8299 -
README-environment-setup-v1.md
- This file (branch-specific info)
Setup Scripts
-
scripts/start-dev-stack.sh
- Complete development stack management -
test_setup.py
- Python 3.13 compatibility validation -
requirements.txt
- Python 3.13 compatible dependencies -
requirements-actions.txt
- Rasa Actions dependencies
Configuration Files
-
.env.example
- Environment variables with dedicated ports -
docker-compose.yml
- Multi-service orchestration -
Backend API:
backend/api/main.py
with Korean language endpoints
π§ Quick Start (environment-setup-v1 branch)
1. Verify Current Setup
# Check you're on the right branch
git branch --show-current # Should show: environment-setup-v1
# Check backend is running
curl http://localhost:8201/health
# View port configuration
curl http://localhost:8201/api/config
2. Development Stack Management
# Check all service status
./scripts/start-dev-stack.sh status
# Start additional services
./scripts/start-dev-stack.sh start
# View logs
./scripts/start-dev-stack.sh logs
3. Docker Setup (if needed)
Follow the guide in this branch: docs/DOCKER-SETUP.md
π Port Allocation (environment-setup-v1)
8200 - Reserved (Health Monitor)
8201 - FastAPI Backend β
RUNNING
8202 - MongoDB Database
8203 - Ollama LLM Service
8204 - Rasa NLU Server
8205 - Rasa Actions Server
8206 - Frontend Development Server
8207 - Vector Store (Qdrant)
8208 - Redis Cache
8209 - Webhook Server
8210 - Unity Development Server
8211 - Unity WebGL Application
8212-8299 - Reserved for expansion
π Key Achievements in This Branch
β Conflict-Free Development
- No interference with ports 3000, 8000, 5000, etc.
- Dedicated range prevents service conflicts
- Clean separation from system services
β Python 3.13 Compatibility
- Working FastAPI backend with minimal dependencies
- Advanced ML packages commented out until ecosystem matures
- Comprehensive compatibility validation
β Production-Ready Architecture
- Docker-ready service configuration
- Health monitoring and status APIs
- Complete environment variable management
π Branch Context
How to Access This Documentation
# Switch to this branch to access all documentation
git checkout environment-setup-v1
# All documentation is available:
ls docs/ # DOCKER-SETUP.md, PORT-ALLOCATION.md
ls scripts/ # start-dev-stack.sh
cat README-environment-setup-v1.md # This file
Integration with Other Branches
- Master branch: May not have these port allocation features
- Other branches: May use different port strategies
- This branch: Specifically designed for 8200-8299 dedicated ports
π Next Steps for This Branch
-
Complete Docker Integration: Install Docker Desktop using
docs/DOCKER-SETUP.md
-
Start Full Stack: Use
docker-compose up -d
with dedicated ports - Add Ollama: Configure LLM service on port 8203
- Unity Integration: Set up WebGL frontend on ports 8206/8211
π― Branch-Specific Commands
# Verify you're on the right branch for these docs
git branch --show-current
# Access branch-specific documentation
cat docs/DOCKER-SETUP.md
cat docs/PORT-ALLOCATION.md
# Use branch-specific scripts
./scripts/start-dev-stack.sh status
# Test branch-specific backend
curl http://localhost:8201/health | python3 -m json.tool
Note: This documentation is specific to the environment-setup-v1
branch. Other branches may have different port allocation strategies or documentation structures.