📐 Paperfold.ai

⭐ Horizon Beta | 🌸 Make amazing origami just by uploading a picture! 🌸

PaperFold.AI is an intuitive, AI-powered web app that turns any image of an origami object into a child-friendly, step-by-step folding guide. Drop a photo, click “Generate Tutorial”, and watch as the Horizon Beta AI model explains where every fold should go—perfect for beginners, educators, and crafty learners of all ages.

✨ Features

📷 Upload-and-Create – simple drag-and-drop or browse for your photo
🧠 AI-Powered Steps – each fold described in beginner language with emojis
🖥️ Streamlined UI – built with modern Streamlit for a smooth user experience
🔑 OpenRouter Integration – configurable API key and gold-standard Horizon Beta model

📦 Quickstart

1. Clone the repo

git clone https://github.com/your-org/paperfold.ai.git
cd paperfold.ai

2. Set up Python ≥ 3.13

Using uv, pipenv, or vanilla venv:

# uv (blazing-fast)
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

# or traditional
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

By default, PaperFold.ai will install educhain, langchain-openai, and streamlit.

3. Get your OpenRouter API key

Register at openrouter.ai
Create a new key and copy it to the sidebar when you launch the app.

4. Launch locally

streamlit run app.py
# Your browser opens at http://localhost:8501

🪧 Usage

Start the App – streamlit run app.py
Enter API Key – paste your OpenRouter API key in the left sidebar
Upload Image – drag a JPG/PNG/PNG of any origami piece into the uploader
Generate Guide – click “✨ Generate Origami Tutorial”
Follow Steps – easy, emoji-rich instructions appear dynamically

🏗️ Tech Stack

Layer	Technology
LLM & Reasoning	OpenRouter (`horizon-beta`) & Educhain
Chat Model	`langchain-openai` ChatOpenAI wrapper
UI & Frontend	Streamlit (Python)
Requirements	uv/pip (see `pyproject.toml`)
OS	macOS, Linux, Windows (Python ≥3.13 recommended)

🧑‍💻 Contributing

We ❤️ contributions! Here’s how to jump in:

Fork & branch
git checkout -b feature/your-awesome-feature
Install dev tools
```
pip install ruff black pytest
```

Run checks

ruff check .               # lint
black . --check            # auto-format check
pytest                     # tests (when added)

Commit with love
Use Conventional Commits:
feat(sidebar): dark-mode switch
Open a Pull Request – describe the problem, the fix, and add screenshots/GIFs for UI changes.

📜 License

Made with ❤️ by Build Fast with AI

MissLostCodes/Paperfold.ai