foreverVM

repo	version
cli
sdk

foreverVM 提供了一个 API，用于安全地运行任意的、有状态的 Python 代码。

foreverVM 的核心概念是 机器 (machines) 和 指令 (instructions)。

机器 代表一个有状态的 Python 进程。您通过在机器上运行 指令 (Python 语句和表达式) 并接收结果来与机器交互。一个机器一次处理一条指令。

入门指南

您需要一个 API token (如果您需要一个，请联系 paul@jamsocket.com)。

尝试 foreverVM 最简单的方法是使用 CLI。 首先，您需要登录：

npx forevervm login

登录后，您可以使用新机器打开 REPL 界面：

npx forevervm repl

当 foreverVM 启动您的机器时，它会给它一个 ID，您以后可以使用该 ID 重新连接到它。 您可以像这样重新连接到一台机器：

npx forevervm repl [machine_name]

您可以像这样列出您的机器（按创建的相反顺序）：

npx forevervm machine list

您不需要终止机器 -- 当机器空闲时，foreverVM 会自动将它们从内存交换到磁盘，然后在需要时自动将它们交换回来。 这就是 foreverVM 能够“永久”运行 repls 的原因。

使用 API

import { ForeverVM } from '@forevervm/sdk'

const token = process.env.FOREVERVM_TOKEN
if (!token) {
  throw new Error('FOREVERVM_TOKEN is not set')
}

// 初始化 foreverVM
const fvm = new ForeverVM({ token })

// 连接到一台新机器。
const repl = fvm.repl()

// 执行一些代码
let execResult = repl.exec('4 + 4')

// 获取结果
console.log('result:', await execResult.result)

// 我们也可以打印 stdout 和 stderr
execResult = repl.exec('for i in range(10):\n  print(i)')

for await (const output of execResult.output) {
  console.log(output.stream, output.data)
}

process.exit(0)

使用标签

您可以创建带有标签的机器，并按标签过滤机器：

import { ForeverVM } from '@forevervm/sdk'

const fvm = new ForeverVM({ token: process.env.FOREVERVM_TOKEN })

// 创建一个带有标签的机器
const machineResponse = await fvm.createMachine({
  tags: { 
    env: 'production', 
    owner: 'user123',
    project: 'demo'
  }
})

// 列出按标签过滤的机器
const productionMachines = await fvm.listMachines({
  tags: { env: 'production' }
})

内存限制

您可以通过指定内存大小（以 MB 为单位）来创建具有内存限制的机器：

// 创建一个具有 512MB 内存限制的机器
const machineResponse = await fvm.createMachine({
  memory_mb: 512,
})