PyMosaygent

A locally running Python API server that powers Mosayic — a development companion for managing full-stack React Native and Python projects with integrated support for Firebase, Google Cloud, GitHub, Expo, and Supabase.

Features

• Environment Management — Configure project directories, detect Python and React Native codebases, track git status
• Expo Dev Server Control — Start, stop, and monitor Metro bundler with live reload support
• Firebase Integration — Manage projects, configure Android/iOS/Web apps, deploy functions, handle secrets
• GitHub Operations — Clone templates, initialize repositories, manage Actions secrets
• Supabase Local Dev — Control local Supabase instance, run migrations, manage database
• Google Cloud Run — Deploy containerized services

Requirements

• Python 3.10 - 3.12
• External CLI tools (depending on features used):
  • firebase-cli and gcloud for Firebase/GCP operations
  • gh for GitHub operations
  • node, npm, expo, and eas for Expo/React Native
  • supabase and docker for Supabase local development
  • git for version control

Installation

uv add mosaygent

For development:

git clone https://github.com/yourusername/pymosaygent
cd pymosaygent
uv sync

Project Structure

pymosaygent/
├── mosaygent/
│   ├── __init__.py           # App entry, service initialization
│   ├── command_runner.py     # Async subprocess execution
│   ├── logger.py             # Colored logging setup
│   ├── middleware.py         # Exception handling
│   ├── routes/               # API endpoints
│   │   ├── environment.py    # Project & codebase management
│   │   ├── expo.py           # Expo dev server control
│   │   ├── firebase.py       # Firebase CLI operations
│   │   ├── github.py         # GitHub & repo operations
│   │   └── supabase.py       # Supabase local dev
│   └── services/             # Business logic
│       ├── environment.py    # Project detection, git ops
│       ├── expo.py           # Expo process management
│       ├── github.py         # GitHub CLI wrapper
│       ├── cloudrun.py       # Cloud Run deployment
│       └── firebase/         # Firebase service modules
├── tests/                    # Test suite
├── pyproject.toml            # Project metadata
└── CLAUDE.md                 # Code standards

API Endpoints

Environment

Expo

Firebase

GitHub

Supabase

Health

Configuration

Project directory is persisted in ~/.mosayic/config.txt and auto-loaded on startup.

Codebase detection:

• Python API: Looks for pyproject.toml in subdirectories
• React Native: Looks for app.json with Expo configuration

Testing

pytest
pytest --cov  # with coverage

License

MIT