Skip to content

README.ko.md

Latest commit

 

History

History
156 lines (114 loc) · 4.27 KB

README.ko.md

File metadata and controls

156 lines (114 loc) · 4.27 KB
Raw

pyproc

pyproc은 브라우저 안에서 동작하는 컴퓨터다. 저장소가 소유하고 worker에서 실행하는 CPython 3.14 WASI kernel을 사용한다. npm package에 검증된 engine과 표준 라이브러리가 포함되므로 별도 engine 다운로드나 원격 실행 서비스가 필요하지 않다.

설치

npm install pyproc

설치된 package를 애플리케이션과 같은 origin에서 제공한다.

Setup

지원 제품 경계는 최신 Chromium과 Edge, SharedArrayBuffer, cross-origin isolation이다.

pyproc을 부팅하는 모든 페이지에 아래 헤더를 붙인다.

Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp

Vite (vite.config.js):

export default {
  server: {
    headers: {
      "Cross-Origin-Opener-Policy": "same-origin",
      "Cross-Origin-Embedder-Policy": "require-corp",
    },
  },
  preview: {
    headers: {
      "Cross-Origin-Opener-Policy": "same-origin",
      "Cross-Origin-Embedder-Policy": "require-corp",
    },
  },
};

Next.js (next.config.js):

module.exports = {
  async headers() {
    return [{
      source: "/:path*",
      headers: [
        { key: "Cross-Origin-Opener-Policy", value: "same-origin" },
        { key: "Cross-Origin-Embedder-Policy", value: "require-corp" },
      ],
    }];
  },
};

이 기계에서 설치 package와 헤더를 확인한다.

npx pyproc-playground

페이지에 헤더나 JSPI가 없으면 checkEnvironment()가 같은 Setup 요구를 보고한다.

Python 실행

import { boot } from "pyproc";

const machine = await boot();
const receipt = await machine.run.python("print(sum(range(100)))");

console.log(receipt.output); // 4950
await machine.close();

모든 실행은 구조화된 receipt를 반환한다. Python 예외는 code === "PYPROC_KERNEL_EXECUTION_ERROR"인 안정된 PyProcError가 된다.

다음

닫은 뒤에도 남기기

import { boot, open } from "pyproc";

const machine = await boot({ deterministic: true });
await machine.run.python("counter = 41");
const image = await machine.history.export();
await machine.close();

const restored = await open(image);
console.log(await restored.run.get("counter")); // 41
await restored.close();

Machine image는 검증된 engine reference와 내용 주소 checkpoint object를 담는다. engine binary를 중복해서 싣지 않는다.

역사 되돌리기

checkpoint, restore, export는 machine.history에 있다.

패키지

파이썬 세션이 이미 쓰는 명령으로 설치한다.

await machine.run.python(`
%pip install pyproc-native-host==1.0.0
import pyproc_native_host
print(pyproc_native_host.ABI_VERSION)
`);

python -m pip install ...도 같은 문이다. import는 보통의 CPython import다. subprocess pip와 임의 native wheel은 이 엔진 밖이다. OS process가 없고 WASI가 그 ABI를 로드하지 못한다. 호스트 계약은 package environment다.

네이티브 Linux Python

기본 boot()는 소유 WASI 커널이다. createWebComputer({ linux })에 linuxOs guest가 있으면 같은 컴퓨터가 그 guest의 serial로 네이티브 Linux CPython도 연다.

import { createWebComputer } from "pyproc";

const computer = createWebComputer({ linux: { V86, manifest } });
await computer.bootAll();
if (computer.linuxPython.available) {
  await computer.linuxPython.run("print(40 + 2)");
  await computer.linuxPython.pip(["install", "demo==1.0.0"]);
}

이 문은 boot()를 대체하지 않는다. 소비자가 V86과 실제로 python3가 들어 있는 Linux image를 공급한다. slim Buildroot linux image에는 CPython이 없다. CPython 3.12.13과 pip는 별도 buildroot-pyproc-python-i686.bin profile이 싣는다.

npm run assets:buildroot-python

제어

Machine Entrance가 설치된 pyproc-control과 MCP 경로를 연다. 나머지 문은 API reference와 platform requirements에 있다.

License

Mozilla Public License 2.0. Copyright 2026 eddmpython.