create-spatius-app 0.1.3-beta.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +12 -10
  2. package/dist/cli.js +199 -207
  3. package/dist/templates.js +183 -199
  4. package/package.json +3 -3
  5. package/templates/cloudflare-livekit/AGENTS.md +2 -0
  6. package/templates/cloudflare-livekit/README.md +10 -0
  7. package/templates/cloudflare-livekit/agent/Dockerfile.pip +8 -0
  8. package/templates/cloudflare-livekit/agent/Dockerfile.uv +8 -0
  9. package/templates/cloudflare-livekit/agent/README.md +16 -1
  10. package/templates/cloudflare-livekit/agent/pyproject.toml +1 -1
  11. package/templates/cloudflare-livekit/agent/src/agent.py +2 -1
  12. package/templates/cloudflare-livekit/agent/tests/test_agent_startup.py +49 -0
  13. package/templates/cloudflare-livekit/agent/uv.lock +14 -14
  14. package/templates/cloudflare-livekit/gitignore +1 -0
  15. package/templates/cloudflare-livekit/package-lock.json +511 -411
  16. package/templates/cloudflare-livekit/package.json +17 -16
  17. package/templates/cloudflare-livekit/pnpm-lock.yaml +572 -480
  18. package/templates/cloudflare-livekit/tests/dev-fixtures.mjs +7 -2
  19. package/templates/cloudflare-livekit/tests/dev-supervision.test.mjs +82 -20
  20. package/templates/layers/agora/AGENTS.md +9 -4
  21. package/templates/layers/agora/README.md +14 -8
  22. package/templates/layers/agora/package-lock.json +6307 -4129
  23. package/templates/layers/agora/package.json +24 -18
  24. package/templates/layers/agora/pnpm-lock.yaml +1765 -563
  25. package/templates/layers/agora/pnpm-workspace.yaml +8 -0
  26. package/templates/layers/agora/scripts/check-worker.mjs +98 -0
  27. package/templates/layers/agora/tsconfig.worker.json +23 -0
  28. package/templates/layers/agora/worker/agora.test.ts +2 -0
  29. package/templates/layers/agora/worker/agora.ts +1 -10
  30. package/templates/layers/agora/worker/index.test.ts +66 -0
  31. package/templates/layers/agora/worker/index.ts +4 -0
  32. package/templates/layers/agora/wrangler.jsonc +24 -0
  33. package/templates/cloudflare-livekit/worker-configuration.d.ts +0 -17184
  34. package/templates/layers/agora/tsconfig.json +0 -16
  35. package/templates/layers/node/Dockerfile +0 -12
  36. package/templates/layers/node/dockerignore +0 -10
  37. package/templates/layers/node/package-lock.json +0 -5569
  38. package/templates/layers/node/pnpm-lock.yaml +0 -3470
  39. package/templates/layers/node/railway.json +0 -8
  40. package/templates/layers/node/scripts/dev-service.mjs +0 -14
  41. package/templates/layers/node/scripts/dev-web.mjs +0 -22
  42. package/templates/layers/node/server/index.ts +0 -92
  43. package/templates/layers/node/vite.config.ts +0 -17
  44. package/templates/layers/railway-agent/agent/railway.json +0 -5
  45. /package/templates/layers/agora/{env.example → dev.vars.example} +0 -0
package/README.md CHANGED
@@ -1,18 +1,19 @@
1
1
  # create-spatius-app
2
2
 
3
- Create a voice-avatar app with Spatius and React. Choose LiveKit with Cloudflare or Railway hosting, or Agora Conversational AI on Zeabur.
3
+ Create a voice-avatar app with Spatius and React. Choose LiveKit or Agora Conversational AI. Both templates run the frontend and API on Cloudflare Workers.
4
4
 
5
5
  ## Quick start
6
6
 
7
7
  Requires Node.js 22.12+ and a [Spatius Studio](https://app.spatius.ai) account.
8
- LiveKit stacks also need Python 3.11–3.14 and a LiveKit Cloud project.
9
- The Agora stack needs an Agora account and no Python tooling.
8
+ The LiveKit template also needs Python 3.11–3.14 and a LiveKit Cloud project.
9
+ The Agora template needs an Agora account and no Python tooling.
10
+ For clean Ctrl+C shutdown with pnpm, use version 12.4.1 or later for both the installed launcher and the project pin.
10
11
 
11
12
  ```sh
12
13
  npx create-spatius-app my-app
13
14
  ```
14
15
 
15
- Choose a tech stack. Follow the remaining prompts to choose package managers, install dependencies, and
16
+ Choose LiveKit or Agora Conversational AI. Follow the remaining prompts to choose package managers, install dependencies, and
16
17
  configure your provider and Spatius credentials.
17
18
  If LiveKit CLI is missing, setup offers to install it using Homebrew on macOS,
18
19
  WinGet on Windows, or LiveKit's Linux installer. You can also enter credentials
@@ -26,7 +27,7 @@ pnpm dev
26
27
  # Or: npm run dev / bun run dev
27
28
  ```
28
29
 
29
- This starts the frontend, API, and, for LiveKit stacks, the Python agent together. Generated DEPLOYMENT.md covers your selected hosting stack.
30
+ This starts the frontend, API, and, for LiveKit, the Python agent together. Generated DEPLOYMENT.md covers deployment to Cloudflare Workers and, for LiveKit, LiveKit Cloud.
30
31
  Open the URL printed in your terminal and start a conversation.
31
32
 
32
33
  ## Use with a coding agent
@@ -47,15 +48,16 @@ npx create-spatius-app setup . --interactive
47
48
 
48
49
  This configures local development only; it does not deploy your app.
49
50
 
50
- ## Choose a stack
51
+ ## Choose a provider
51
52
 
52
53
  ```sh
53
- npx create-spatius-app my-app --stack railway-livekit
54
+ npx create-spatius-app my-app --stack cloudflare-livekit
55
+ # Or:
56
+ npx create-spatius-app my-app --stack cloudflare-agora
54
57
  ```
55
58
 
56
- Cloudflare and Railway web hosting can each be paired with LiveKit Cloud Agents
57
- or a LiveKit agent on Railway. The default is Cloudflare + LiveKit Cloud Agents.
58
- The `zeabur-agora` stack requires no Python tooling.
59
+ LiveKit is the default and deploys its Python agent to LiveKit Cloud.
60
+ Agora Conversational AI hosts the agent itself; its template needs no Python.
59
61
 
60
62
  ## More options
61
63