feat: add nodejs, python, and bash quickstart examples

Author: NathanFlurry

examples/quickstart/package.json

@@ -15,6 +15,9 @@
 		"tools": "node --import tsx src/tools.ts",
 		"agent-session": "node --import tsx src/agent-session.ts",
 		"sandbox": "node --import tsx src/sandbox.ts",
+		"nodejs": "node --import tsx src/nodejs.ts",
+		"python": "node --import tsx src/python.ts",
+		"bash": "node --import tsx src/bash.ts",
 		"s3-filesystem": "node --import tsx src/s3-filesystem.ts"
 	},
 	"dependencies": {
@@ -25,6 +28,7 @@
 		"@rivet-dev/agent-os-git": "link:../../registry/software/git",
 		"@rivet-dev/agent-os-pi": "link:../../registry/agent/pi",
 		"@rivet-dev/agent-os-s3": "link:../../registry/file-system/s3",
+		"pyodide": "^0.28.3",
 		"zod": "^3.25.0"
 	},
 	"devDependencies": {

examples/quickstart/src/bash.ts

@@ -0,0 +1,31 @@
+// Run shell commands inside the VM.
+
+import { AgentOs } from "@rivet-dev/agent-os-core";
+import common from "@rivet-dev/agent-os-common";
+
+const vm = await AgentOs.create({ software: [common] });
+
+// Simple commands
+const echo = await vm.exec("echo 'Hello from the shell!'");
+console.log(echo.stdout);
+
+// Pipes
+const piped = await vm.exec("echo 'hello world' | tr a-z A-Z");
+console.log("Piped:", piped.stdout.trim());
+
+// File manipulation
+await vm.exec("echo 'line 1' > /tmp/test.txt");
+await vm.exec("echo 'line 2' >> /tmp/test.txt");
+await vm.exec("echo 'line 3' >> /tmp/test.txt");
+
+const cat = await vm.exec("cat /tmp/test.txt");
+console.log("File contents:");
+console.log(cat.stdout);
+
+// grep
+const grep = await vm.exec("grep '2' /tmp/test.txt");
+console.log("Grep result:", grep.stdout.trim());
+
+console.log("Exit code:", grep.exitCode);
+
+await vm.dispose();

examples/quickstart/src/nodejs.ts

@@ -0,0 +1,35 @@
+// Run a Node.js script inside the VM that does filesystem operations.
+
+import { AgentOs } from "@rivet-dev/agent-os-core";
+import common from "@rivet-dev/agent-os-common";
+
+const vm = await AgentOs.create({ software: [common] });
+
+await vm.writeFile(
+	"/tmp/demo.mjs",
+	`
+import fs from "fs";
+import path from "path";
+
+// Create a directory and write files
+fs.mkdirSync("/project/src", { recursive: true });
+fs.writeFileSync("/project/src/index.js", 'console.log("hello");');
+fs.writeFileSync("/project/README.md", "# My Project");
+
+// Read them back
+const files = fs.readdirSync("/project", { recursive: true });
+console.log("Files:", files);
+
+const content = fs.readFileSync("/project/src/index.js", "utf8");
+console.log("index.js:", content);
+
+const stat = fs.statSync("/project/README.md");
+console.log("README size:", stat.size, "bytes");
+`,
+);
+
+const result = await vm.exec("node /tmp/demo.mjs");
+console.log(result.stdout);
+console.log("Exit code:", result.exitCode);
+
+await vm.dispose();

examples/quickstart/src/python.ts

@@ -0,0 +1,39 @@
+// Run a Python script inside the VM that does filesystem operations.
+
+import { AgentOs } from "@rivet-dev/agent-os-core";
+import common from "@rivet-dev/agent-os-common";
+
+const vm = await AgentOs.create({ software: [common] });
+
+await vm.writeFile(
+	"/tmp/demo.py",
+	`
+import os
+import json
+
+# Create a directory and write files
+os.makedirs("/project/src", exist_ok=True)
+
+with open("/project/src/main.py", "w") as f:
+    f.write("print('hello')")
+
+with open("/project/README.md", "w") as f:
+    f.write("# My Project")
+
+# Read them back
+files = os.listdir("/project")
+print("Files:", files)
+
+with open("/project/src/main.py") as f:
+    print("main.py:", f.read())
+
+stat = os.stat("/project/README.md")
+print("README size:", stat.st_size, "bytes")
+`,
+);
+
+const result = await vm.exec("python /tmp/demo.py");
+console.log(result.stdout);
+console.log("Exit code:", result.exitCode);
+
+await vm.dispose();