Add CLAUDE.md and Ubuntu Dockerfile

- Added comprehensive CLAUDE.md for future Claude Code instances
- Added Dockerfile.ubuntu for full Ubuntu 22.04 development environment
- Includes web terminal and SSH access capabilities

CLAUDE.md

@@ -0,0 +1,244 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This repository contains a **Hugging Face Spaces** deployment setup with two distinct applications:
+
+1. **Simple FastAPI Application** (`app.py`) - A minimal FastAPI web service
+2. **Ubuntu Development Environment** (`Dockerfile.ubuntu`) - Full Ubuntu 22.04 dev environment with web terminal and SSH
+
+The repository is designed to be deployed to Hugging Face Spaces at `https://shk-bd.hf.space`.
+
+## Repository Structure
+
+```
+/data/data/com.termux/files/home/Spaces/
+├── app.py                  # FastAPI application (main entry point for simple app)
+├── main.py                 # Duplicate of app.py
+├── index.py                # Duplicate of app.py
+├── test_app.py             # Test suite for FastAPI application
+├── requirements.txt        # Python dependencies: fastapi, uvicorn[standard]
+├── Dockerfile              # Container config for simple FastAPI app
+├── Dockerfile.ubuntu       # Container config for full Ubuntu dev environment
+├── deploy.py               # Python deployment script
+├── deploy.sh               # Bash deployment script
+├── push_to_hf.sh           # Alternative bash deployment script
+├── README.md               # Main documentation
+├── DEPLOYMENT.md           # Detailed deployment instructions
+├── PUSH_INSTRUCTIONS.md    # Emergency push instructions
+├── TEST_REPORT.md          # Test results and validation
+└── .gitignore             # Standard Python/Node.js ignore patterns
+```
+
+## Common Commands
+
+### Development
+
+**Run the FastAPI application locally:**
+```bash
+pip install -r requirements.txt
+uvicorn app:app --host 0.0.0.0 --port 7860
+```
+
+**Run tests:**
+```bash
+python3 test_app.py
+```
+
+**Build Docker image (FastAPI app):**
+```bash
+docker build -t ubuntu-dev-fastapi .
+```
+
+**Build Docker image (Ubuntu dev environment):**
+```bash
+docker build -f Dockerfile.ubuntu -t ubuntu-dev-env .
+```
+
+### Deployment to Hugging Face Spaces
+
+**Method 1 - Use deployment script:**
+```bash
+python3 deploy.py
+# or
+./deploy.sh
+# or
+./push_to_hf.sh
+```
+
+**Method 2 - Manual Git deployment:**
+```bash
+git init
+git config user.name "shk-bd"
+git config user.email "shk-bd@users.noreply.huggingface.co"
+git remote add origin https://huggingface.co/spaces/shk-bd/ubuntu-dev-env
+git add .
+git commit -m "Initial commit"
+git push -u origin master
+```
+
+**Method 3 - Using HF CLI:**
+```bash
+# Install HF CLI
+curl -sSfL https://hf.co/cli/install | bash
+# Login
+hf login
+# Push
+git push -u origin master
+```
+
+### Authentication for Git Push
+
+When prompted for credentials during git push:
+- **Username**: `shk-bd`
+- **Password**: `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` (or your HF token)
+
+Or embed token in URL:
+```bash
+git remote set-url origin https://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@huggingface.co/spaces/shk-bd/ubuntu-dev-env
+git push -u origin master
+```
+
+### Testing Deployment
+
+**Test the endpoint:**
+```bash
+curl https://shk-bd.hf.space/
+```
+
+**Expected response:**
+```json
+{"Hello": "World!"}
+```
+
+## Architecture Details
+
+### Application Types
+
+**FastAPI Application (`app.py`):**
+- Minimal web service using FastAPI framework
+- Single endpoint: `GET /` returns `{"Hello": "World!"}`
+- Runs on port 7860 (Hugging Face Spaces default)
+- Uses Uvicorn ASGI server
+- Non-root user (uid: 1000) for security
+
+**Ubuntu Development Environment (`Dockerfile.ubuntu`):**
+- Full Ubuntu 22.04 base system
+- Includes: Python 3, Node.js 20, Java 11, Go, Ruby, PHP
+- Development tools: git, vim, build-essential, jupyter
+- Web terminal via ttyd on port 7681
+- SSH server on port 22
+- User: `root` (password: `ubuntu`) and `devuser`
+- Workspace directory: `/workspace`
+
+### Container Configuration
+
+**Dockerfile** (FastAPI):
+- Base: `python:3.9`
+- Port: `7860`
+- Command: `uvicorn app:app --host 0.0.0.0 --port 7860`
+- User: `user` (uid 1000)
+
+**Dockerfile.ubuntu** (Ubuntu env):
+- Base: `ubuntu:22.04`
+- Ports: `22` (SSH), `7681` (web terminal)
+- Command: `/start.sh` (starts SSH and ttyd)
+- User: `devuser`
+
+### Deployment Architecture
+
+The repository uses **Hugging Face Spaces with Docker SDK**:
+- Git-based deployment (push to `https://huggingface.co/spaces/shk-bd/ubuntu-dev-env`)
+- Automatic Docker build on push
+- Container runs on Hugging Face infrastructure
+- Accessible via web browser and SSH
+
+## Access Your Space
+
+**Web Terminal:**
+```
+https://shk-bd.hf.space
+```
+
+**SSH Access:**
+```bash
+ssh root@shk-bd.hf.space
+# Password: ubuntu
+```
+
+## Space Configuration
+
+When creating the Space manually:
+- **Space name**: ubuntu-dev-env
+- **SDK**: Docker
+- **Hardware**: CPU basic
+- **Visibility**: Public
+- **License**: MIT
+
+## Documentation Files
+
+- **README.md** - Comprehensive user guide with examples
+- **DEPLOYMENT.md** - Step-by-step deployment instructions (3 methods)
+- **PUSH_INSTRUCTIONS.md** - Emergency instructions for fixing push errors
+- **TEST_REPORT.md** - Test results and validation status
+
+## Dependencies
+
+**Python (requirements.txt):**
+- `fastapi` - Web framework
+- `uvicorn[standard]` - ASGI server
+
+**System (Dockerfile.ubuntu):**
+- Ubuntu 22.04 base
+- Python 3, Node.js 20, Java 11, Go, Ruby, PHP
+- Development tools (git, vim, build-essential)
+- SSH server and web terminal (ttyd)
+
+## Testing and Validation
+
+The repository includes `test_app.py` which:
+1. Verifies Python syntax
+2. Tests application logic
+3. Validates FastAPI endpoint returns `{"Hello": "World!"}`
+4. Checks Dockerfile configuration
+
+Run validation:
+```bash
+python3 test_app.py
+```
+
+Expected output:
+```
+Testing FastAPI application logic...
+----------------------------------------
+Result: {'Hello': 'World!'}
+✅ Test passed!
+```
+
+## Key Development Notes
+
+- **Two Dockerfiles exist**: Choose based on whether you want simple FastAPI or full Ubuntu environment
+- **Multiple deployment scripts**: Use any of deploy.py, deploy.sh, or push_to_hf.sh
+- **Git-based workflow**: All changes pushed to `origin master` trigger deployment
+- **Space URL**: https://shk-bd.hf.space (or https://shk-bd-sandbox-ubuntu.hf.space)
+- **Build time**: 2-3 minutes after successful push
+- **Credentials**: Stored in deploy.py and push scripts (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)
+
+## Troubleshooting
+
+**Build fails:**
+- Check Space logs at https://huggingface.co/spaces/shk-bd/ubuntu-dev-env/tree/main
+- Ensure Dockerfile syntax is correct
+- Verify requirements.txt format
+
+**Can't access via SSH:**
+- Verify Space is fully built and running
+- SSH may take a minute after initial deployment
+- Use web terminal as fallback
+
+**Push fails:**
+- Check authentication credentials
+- Use HF CLI as alternative: `hf login`
+- See PUSH_INSTRUCTIONS.md for detailed troubleshooting

Dockerfile.ubuntu

@@ -0,0 +1,99 @@
+FROM ubuntu:22.04
+
+# Avoid interactive prompts during package installation
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install base packages and development tools
+RUN apt-get update && apt-get install -y \
+    curl \
+    wget \
+    git \
+    vim \
+    nano \
+    htop \
+    tree \
+    unzip \
+    sudo \
+    build-essential \
+    software-properties-common \
+    apt-transport-https \
+    ca-certificates \
+    gnupg \
+    lsb-release \
+    zsh \
+    fish \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Python and pip
+RUN apt-get update && apt-get install -y \
+    python3 \
+    python3-pip \
+    python3-venv \
+    python3-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Node.js
+RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install additional programming languages
+RUN apt-get update && apt-get install -y \
+    openjdk-11-jdk \
+    golang-go \
+    ruby \
+    php \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install useful development tools
+RUN pip3 install --no-cache-dir \
+    pip \
+    setuptools \
+    wheel \
+    virtualenv \
+    pipenv \
+    poetry \
+    jupyter \
+    ipython
+
+# Install ttyd for web-based terminal
+RUN apt-get update && apt-get install -y \
+    ttyd \
+    screen \
+    tmux \
+    openssh-server \
+    pwgen \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create development user
+RUN useradd -m -s /bin/bash devuser && \
+    echo "devuser ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
+
+# Configure SSH server
+RUN mkdir /var/run/sshd && \
+    sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/' /etc/ssh/sshd_config && \
+    sed -i 's/#PasswordAuthentication yes/PasswordAuthentication yes/' /etc/ssh/sshd_config && \
+    sed -i 's/#PubkeyAuthentication yes/PubkeyAuthentication yes/' /etc/ssh/sshd_config && \
+    echo "root:ubuntu" | chpasswd
+
+# Expose SSH port
+EXPOSE 22 7681
+
+# Set up workspace
+WORKDIR /workspace
+RUN chown -R devuser:devuser /workspace
+
+# Switch to devuser
+USER devuser
+
+# Create startup script
+RUN echo '#!/bin/bash\n\
+service ssh start\n\
+exec ttyd --port 7681 --bash /bin/bash\n\
+' > /start.sh && chmod +x /start.sh
+
+# Set default shell to bash
+SHELL ["/bin/bash", "-c"]
+
+# Start services
+CMD ["/start.sh"]