Add Reachy Mini OpenShell demo project

.gitignore

@@ -1,102 +1,136 @@
-# Operating system files
+# OS and editor noise
 .DS_Store
 Thumbs.db
 Desktop.ini
-
-# Editors and IDEs
+*.swp
+*.swo
+*~
 .idea/
 .vscode/
+!.vscode/extensions.json
+!.vscode/settings.json
 *.code-workspace
 *.suo
 *.user
-*.swp
-*.swo
-*~
-
-# Local scratch work
-.scratch/
 
-# Environment files and private configuration
+# Secrets and local environment
 .env
 .env.*
 !.env.example
 !.env.sample
 !.env.template
-*.pem
+*.local
 *.key
+*.pem
+*.crt
+*.csr
 *.p12
 *.pfx
 *.jks
 credentials*.json
 secrets*.json
 
-# Logs, temporary files, and local caches
+# Logs
 *.log
-*.pid
-*.seed
-*.tmp
-*.temp
-*.bak
+logs/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Temporary and cache directories
 .cache/
+.uv-cache/
 .tmp/
 tmp/
+temp/
+*.tmp
+*.temp
+*.bak
+.scratch/
 
-# Rust
-target/
-**/*.rs.bk
-*.profraw
-*.profdata
-
-# Python bytecode and caches
+# Python
 __pycache__/
 *.py[cod]
 *$py.class
+*.so
+.Python
+.venv/
+.venv-*/
+venv/
+ENV/
+env/
+pip-wheel-metadata/
+*.egg-info/
+.eggs/
+build/
+dist/
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
 .pytest_cache/
 .mypy_cache/
-.pyright/
 .ruff_cache/
 .ty/
+.pyright/
+.pyre/
+.pytype/
 .hypothesis/
 .tox/
 .nox/
-.coverage
-.coverage.*
-coverage.xml
-htmlcov/
+.dmypy.json
+dmypy.json
+.ipynb_checkpoints/
 
-# Python environments and packaging output
-.venv/
-.venv-*/
-venv/
-env/
-ENV/
-build/
-dist/
-*.egg-info/
-.eggs/
-pip-wheel-metadata/
+# Rust
+target/
+**/*.rs.bk
+*.profraw
+*.profdata
 
-# TypeScript and Node.js dependencies
+# JavaScript and TypeScript
 node_modules/
+.npm/
 .pnpm-store/
 .yarn/cache/
+.yarn/unplugged/
+.yarn/build-state.yml
 .yarn/install-state.gz
-.npm/
-.eslintcache
+dist/
+build/
+coverage/
+.nyc_output/
 *.tsbuildinfo
-
-# TypeScript and frontend build output
-lib/
-out/
+*.eslintcache
+.vite/
+.turbo/
+.parcel-cache/
+.angular/cache/
 .next/
 .nuxt/
 .svelte-kit/
+.output/
+.vercel/
+.netlify/
+.serverless/
+out/
+lib/
 .astro/
-.parcel-cache/
-.turbo/
-.vite/
-coverage/
 
-# Generated documentation sites
+# Static site and docs output
 public/
 site/
+.docusaurus/
+.vitepress/cache/
+.vitepress/dist/
+
+# Runtime artifacts
+*.pid
+*.seed
+*.pid.lock
+
+# Package artifacts
+*.tgz
+*.tar.gz
+*.zip

README.md

@@ -14,8 +14,8 @@ OpenShell as the runtime.
 - `docs/dev-notes/authors.json` contains reusable Dev Notes author metadata.
 - `docs/documentation/` contains durable guides and references for packages,
   libraries, benchmarks, and examples introduced in Dev Notes.
-- `projects/` contains self-contained research projects and a reusable Python
-  project template.
+- `projects/` contains self-contained research projects, including the reusable
+  Python project template and the Reachy Mini conversation demo for OpenShell.
 - `scripts/render-dev-notes.py` renders Dev Notes cards, post bylines, and
   navigation entries from post front matter.
 - `zensical.toml` configures the documentation site.

docs/index.md

@@ -28,5 +28,11 @@ hide:
         <span>Guides and reference material for packages, libraries, benchmarks, and examples introduced in Dev Notes.</span>
       </span>
     </a>
+    <a class="openshell-home-link" href="projects/">
+      <span class="openshell-home-link__copy">
+        <strong>Projects</strong>
+        <span>Runnable research demos with setup guides, validation commands, and troubleshooting notes, including the Reachy Mini conversation demo.</span>
+      </span>
+    </a>
   </nav>
 </div>

docs/projects/index.md

@@ -0,0 +1,21 @@
+# Projects
+
+Projects are runnable research demos with their own source code, dependencies,
+setup guide, validation commands, and troubleshooting notes.
+
+## Current Projects
+
+- [Reachy Mini conversation demo](reachy-mini-openshell.md): a simulator-first
+  Reachy Mini + OpenShell demo with an OpenAI Realtime quick start, Gradio UI,
+  microphone or text input, optional local speech backends, and Reachy movement
+  tools.
+
+## Project Page Standard
+
+Each project page should help a new contributor answer five questions quickly:
+
+- What does it run?
+- What do I need installed or configured?
+- Which command starts the local demo?
+- How do I know it is working?
+- Where do I look when it fails?