Skip to content

Remo

Remo helps regular people who could not afford interior designer to come up with a plan that fits preference and provide a shopping list to realize the vision.

Core trick

Generates redesign images from a room photo and chat-gathered style preferences, then edits them iteratively from user annotations.

Tags

Description

Remo helps regular people who could not afford interior designer to come up with a plan that fits preference and provide a shopping list to realize the vision.
hippogriff-ai/remo★ 21 forksPythonMITCreated Feb 10, 2026 · last push Apr 27, 2026

README excerpt

# Remo

AI-powered room redesign iOS app. Photograph a room, describe your style via an AI chat, receive photorealistic redesign options, iteratively refine with annotation-based editing, and get a shoppable product list.
[Demo link](https://www.youtube.com/watch?v=cwqyoOuIJHI)
## Prerequisites

- **Docker & Docker Compose** (PostgreSQL + Temporal)
- **Python 3.12+**
- **Xcode 15+** / Swift 5.9+ (iOS development)

## Quick Start

### 1. Environment

```bash
cp .env.example .env
# Fill in API keys (at minimum ANTHROPIC_API_KEY for local dev with mocks)
```

Key variables:

| Variable | Purpose | Required |
|----------|---------|----------|
| `ANTHROPIC_API_KEY` | Claude (intake agent, photo validation) | Yes |
| `GOOGLE_AI_API_KEY` | Gemini (image generation) | For real image gen |
| `EXA_API_KEY` | Product search (shopping list) | For real shopping |
| `R2_ACCOUNT_ID` / `R2_ACCESS_KEY_ID` / `R2_SECRET_ACCESS_KEY` | Cloudflare R2 (image storage) | For real storage |
| `USE_TEMPORAL` | Enable Temporal workflows (`false` = mock mode) | No (default: `false`) |
| `USE_MOCK_ACTIVITIES` | Stub AI calls (`true` = fast dev) | No (default: `true`) |

### 2. Infrastructure

```bash
docker compose up -d    # PostgreSQL (5432) + Temporal (7233) + Temporal UI (8233)
```

### 3. Backend

```bash
cd backend
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Run migrations
DATABASE_URL="postgresql+asyncpg://remo:remo_dev@localhost:5432/remo" \
    python -m alembic u

Team