create-pyric 0.1.0-alpha.12 → 0.1.0-alpha.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pyric",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.13",
   "license": "Apache-2.0",
   "homepage": "https://pyric.dev",
   "repository": {

package/templates/chat/.env.example

@@ -12,9 +12,11 @@ VITE_FIREBASE_DATABASE_URL=
 # production FCM token registration; the dev sandbox mints tokens without it.
 VITE_FIREBASE_VAPID_KEY=
 
-# Optional local OpenAI-compatible model. Leave both unset to use Pyric's
-# built-in scripted AI. MiniMax example:
-# PYRIC_AI_PROXY_UPSTREAM=http://localhost:8080/v1
-# PYRIC_AI_MODEL=minimax-m2.7
-PYRIC_AI_PROXY_UPSTREAM=
+# Optional local model. Setting this switches from Pyric's scripted AI to its
+# OpenAI-compatible engine and supplies the model name sent upstream.
+# The model-only path uses Ollama at http://localhost:11434/v1 by default.
+# Example: ollama pull qwen3:4b
 PYRIC_AI_MODEL=
+# Override only for another OpenAI-compatible model server. This is the
+# server-side base URL, not the browser proxy path; include /v1 when required.
+PYRIC_AI_PROXY_UPSTREAM=

package/templates/chat/README.md

@@ -13,16 +13,41 @@ npm run dev
 ```
 
 With no model configuration, Pyric's built-in scripted engine answers locally.
-To use MiniMax or another OpenAI-compatible server, copy `.env.example` to
-`.env.local` and set both:
+To use Ollama, pull a model, copy `.env.example` to `.env.local`, and select it:
+
+```bash
+ollama pull qwen3:4b
+```
+
+```dotenv
+PYRIC_AI_MODEL=qwen3:4b
+```
+
+Pyric forwards the unchanged `firebase/ai` calls to Ollama's default
+OpenAI-compatible endpoint at `http://localhost:11434/v1`. For another model
+server, also set its base URL (including `/v1` when required):
 
 ```dotenv
-PYRIC_AI_PROXY_UPSTREAM=http://localhost:8080/v1
 PYRIC_AI_MODEL=minimax-m2.7
+PYRIC_AI_PROXY_UPSTREAM=http://localhost:8080/v1
 ```
 
-Start that server separately, then restart Vite. The scaffold deliberately does
-not assume an operating system or a particular model launcher.
+Start the model server separately, then restart Vite.
+See the [Pyric AI Logic guide](https://pyric.dev/docs/build/ai-logic/) for the full
+engine and proxy behaviour.
+
+For a one-off run on macOS, Linux, or another POSIX shell, prefix the same
+command with the variables:
+
+```bash
+PYRIC_AI_MODEL=qwen3:4b \
+PYRIC_AI_PROXY_UPSTREAM=http://localhost:11434/v1 \
+npm run dev
+```
+
+Do not put `&&` before `npm run dev`: that makes the values unexported shell
+variables instead of environment variables for Vite. Use `.env.local` for the
+normal, persistent setup.
 
 ## What runs in the sandbox
 
@@ -38,6 +63,15 @@ The same bundled module service worker handles `onBackgroundMessage` in local
 development and production. Local delivery still requires an open page to keep
 the Pyric sandbox alive.
 
+## Runtime status
+
+Pyric adds a collapsed runtime chip to the bottom-right corner during Vite
+development. It signals sandbox errors and tells you when the long-lived worker
+needs an update. Open it to copy an error, activate the new worker safely,
+or open Pyric Studio in a new tab. Updating finishes accepted sandbox work and
+then reloads every connected tab onto the new worker. The chip is not included
+in a normal production build.
+
 ## Test and build
 
 ```bash

package/templates/chat/functions/index.js

@@ -24,7 +24,7 @@ export const onPresenceOnline = onValueCreated('/presence/{uid}', async (event)
   const profile = getFirestore().collection('users').doc(uid);
   const snapshot = await profile.get();
   const now = FieldValue.serverTimestamp();
-  const seen = snapshot.exists && snapshot.get('firstSeenAt')
+  const seen = snapshot.exists && snapshot.data()?.firstSeenAt
     ? { lastSeenAt: now }
     : { firstSeenAt: now, lastSeenAt: now };
   await profile.set(seen, { merge: true });

package/templates/chat/vite.config.ts

@@ -1,4 +1,4 @@
-import { defineConfig, loadEnv } from 'vite';
+import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 import tailwindcss from '@tailwindcss/vite';
 import { pyric } from '@pyric/cli/vite';
@@ -11,44 +11,11 @@ import path from 'node:path';
 // self-contained sandbox preview you can serve under `pyric dev`, build with a
 // non-production mode: `vite build --mode development` (see the `build:sandbox`
 // script). That output is marked and can never be deployed.
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd(), '');
-  const proxyUpstream = env.PYRIC_AI_PROXY_UPSTREAM;
-  const model = env.PYRIC_AI_MODEL;
-  if (Boolean(proxyUpstream) !== Boolean(model)) {
-    throw new Error(
-      'PyChat local AI configuration requires both PYRIC_AI_PROXY_UPSTREAM and PYRIC_AI_MODEL.',
-    );
-  }
-
-  return {
-    plugins: [
-      react(),
-      tailwindcss(),
-      pyric({
-        bridge: true,
-        // The authored 2+modules source is the source of truth; the plugin
-        // resolves it in-memory, so no vendored firestore.rules is needed in
-        // dev. `npm run rules:resolve` still generates it for Firebase deploy.
-        rules: 'firestore.modules.rules',
-        ...(proxyUpstream && model
-          ? {
-              ai: {
-                proxyUpstream,
-                engine: {
-                  kind: 'openai' as const,
-                  model,
-                  modelMap: { 'gemini-2.5-flash': model },
-                },
-              },
-            }
-          : {}),
-      }),
-    ],
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, './src'),
-      },
+export default defineConfig({
+  plugins: [react(), tailwindcss(), pyric()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
     },
-  };
+  },
 });