create-spatius-app 0.1.1 → 0.1.3-beta.1
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.
- package/README.md +17 -8
- package/dist/cli.js +8264 -162
- package/dist/templates.js +8226 -128
- package/package.json +5 -5
- package/schemas/result-v3.schema.json +174 -0
- package/schemas/result-v4.schema.json +170 -0
- package/templates/cloudflare-livekit/AGENTS.md +4 -0
- package/templates/cloudflare-livekit/README.md +41 -0
- package/templates/cloudflare-livekit/agent/README.md +0 -4
- package/templates/cloudflare-livekit/agent/env.example +3 -0
- package/templates/cloudflare-livekit/agent/pyproject.toml +1 -1
- package/templates/cloudflare-livekit/agent/src/agent.py +5 -3
- package/templates/cloudflare-livekit/agent/uv.lock +7 -7
- package/templates/cloudflare-livekit/package-lock.json +70 -142
- package/templates/cloudflare-livekit/package.json +2 -2
- package/templates/cloudflare-livekit/pnpm-lock.yaml +197 -153
- package/templates/cloudflare-livekit/tests/dev-events.test.mjs +23 -0
- package/templates/cloudflare-livekit/tests/dev-fixtures.mjs +7 -3
- package/templates/cloudflare-livekit/tsconfig.web.json +1 -0
- package/templates/cloudflare-livekit/tsconfig.worker.json +1 -0
- package/templates/cloudflare-livekit/web/api.ts +12 -0
- package/templates/cloudflare-livekit/web/components/agents-ui/agent-chat-transcript.tsx +6 -90
- package/templates/cloudflare-livekit/web/components/transcript-view.tsx +90 -0
- package/templates/cloudflare-livekit/web/session-attempt.ts +23 -2
- package/templates/cloudflare-livekit/worker/capability.test.ts +31 -0
- package/templates/cloudflare-livekit/worker/capability.ts +72 -0
- package/templates/cloudflare-livekit/worker/index.test.ts +2 -2
- package/templates/cloudflare-livekit/worker/index.ts +15 -3
- package/templates/cloudflare-livekit/worker/session.ts +34 -0
- package/templates/layers/agora/AGENTS.md +8 -0
- package/templates/layers/agora/README.md +19 -0
- package/templates/layers/agora/env.example +9 -0
- package/templates/layers/agora/package-lock.json +6068 -0
- package/templates/layers/agora/package.json +54 -0
- package/templates/layers/agora/pnpm-lock.yaml +3816 -0
- package/templates/layers/agora/tsconfig.json +16 -0
- package/templates/layers/agora/vitest.config.ts +4 -0
- package/templates/layers/agora/web/App.tsx +174 -0
- package/templates/layers/agora/web/agora-session.test.ts +70 -0
- package/templates/layers/agora/web/agora-session.ts +267 -0
- package/templates/layers/agora/worker/agora.test.ts +60 -0
- package/templates/layers/agora/worker/agora.ts +165 -0
- package/templates/layers/agora/worker/index.ts +50 -0
- package/templates/layers/catalog/DEPLOYMENT.md +3 -0
- package/templates/layers/catalog/spatius.config.json +1 -0
- package/templates/layers/node/Dockerfile +12 -0
- package/templates/layers/node/dockerignore +10 -0
- package/templates/layers/node/package-lock.json +5569 -0
- package/templates/layers/node/pnpm-lock.yaml +3470 -0
- package/templates/layers/node/railway.json +8 -0
- package/templates/layers/node/scripts/dev-service.mjs +14 -0
- package/templates/layers/node/scripts/dev-web.mjs +22 -0
- package/templates/layers/node/server/index.ts +92 -0
- package/templates/layers/node/vite.config.ts +17 -0
- package/templates/layers/railway-agent/agent/railway.json +5 -0
- package/dist/cli.js.map +0 -1
- package/dist/templates.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,20 +1,19 @@
|
|
|
1
1
|
# create-spatius-app
|
|
2
2
|
|
|
3
|
-
Create a voice-avatar app with Spatius
|
|
4
|
-
|
|
5
|
-
> Preview: the CLI is not yet published to npm. The commands below will be
|
|
6
|
-
> available after the first release.
|
|
3
|
+
Create a voice-avatar app with Spatius and React. Choose LiveKit with Cloudflare or Railway hosting, or Agora Conversational AI on Zeabur.
|
|
7
4
|
|
|
8
5
|
## Quick start
|
|
9
6
|
|
|
10
|
-
Requires Node.js 22
|
|
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.
|
|
11
10
|
|
|
12
11
|
```sh
|
|
13
12
|
npx create-spatius-app my-app
|
|
14
13
|
```
|
|
15
14
|
|
|
16
|
-
Follow the prompts to choose package managers, install dependencies, and
|
|
17
|
-
configure your
|
|
15
|
+
Choose a tech stack. Follow the remaining prompts to choose package managers, install dependencies, and
|
|
16
|
+
configure your provider and Spatius credentials.
|
|
18
17
|
If LiveKit CLI is missing, setup offers to install it using Homebrew on macOS,
|
|
19
18
|
WinGet on Windows, or LiveKit's Linux installer. You can also enter credentials
|
|
20
19
|
manually or finish setup later.
|
|
@@ -27,7 +26,7 @@ pnpm dev
|
|
|
27
26
|
# Or: npm run dev / bun run dev
|
|
28
27
|
```
|
|
29
28
|
|
|
30
|
-
This starts the frontend,
|
|
29
|
+
This starts the frontend, API, and, for LiveKit stacks, the Python agent together. Generated DEPLOYMENT.md covers your selected hosting stack.
|
|
31
30
|
Open the URL printed in your terminal and start a conversation.
|
|
32
31
|
|
|
33
32
|
## Use with a coding agent
|
|
@@ -48,6 +47,16 @@ npx create-spatius-app setup . --interactive
|
|
|
48
47
|
|
|
49
48
|
This configures local development only; it does not deploy your app.
|
|
50
49
|
|
|
50
|
+
## Choose a stack
|
|
51
|
+
|
|
52
|
+
```sh
|
|
53
|
+
npx create-spatius-app my-app --stack railway-livekit
|
|
54
|
+
```
|
|
55
|
+
|
|
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
|
+
|
|
51
60
|
## More options
|
|
52
61
|
|
|
53
62
|
```sh
|