Skip to content

README.en.md

Latest commit

 

History

History
170 lines (120 loc) · 10.7 KB

README.en.md

File metadata and controls

170 lines (120 loc) · 10.7 KB
Raw

Cell Coding

GitHub Pages License Issues Discussions

한국어 README | English

A biological programming paradigm for Physical AI, built on event-driven architecture.
피지컬 AI를 위한 이벤트 기반 생물학적 프로그래밍 패러다임.

Cell Coding is not a campaign to replace existing frameworks. It is an extensible architecture model that runs on top of TypeScript, Python, and React.
Cell Coding은 기존 프레임워크를 대체하려는 언어 운동이 아니라, TypeScript·Python·React 위에서 동작하는 확장형 아키텍처 모델입니다.

Why this was created | 왜 이 개념을 만들었는가

Classical software assumes a relatively narrow input -> process -> output model.
고전 소프트웨어는 비교적 좁은 입력 -> 처리 -> 출력 모델을 전제로 합니다.

Historically, inputs expanded from keyboard/mouse to camera/microphone/location data, while outputs remained mostly screen- and printer-centric.
역사적으로 입력은 키보드/마우스에서 카메라/마이크/위치정보로 확장됐지만, 출력은 여전히 화면·프린터 중심에 머무는 경우가 많았습니다.

Physical AI changes both sides at once: many sensory channels and many real-world action channels.
Physical AI는 양쪽을 동시에 바꿉니다. 다중 감각 채널과 다중 현실 행동 채널이 함께 등장합니다.

Problem reframe | 문제 재정의

For embodied systems, treating everything as plain I/O is often too reductive.
구현체(embodied) 시스템에서는 모든 것을 단순 I/O로 취급하는 방식이 과도하게 단순화될 수 있습니다.

We need a software model where many specialized functions coexist as living units, not just pipeline steps.
우리는 파이프라인 단계가 아니라, 다수의 특화 기능이 살아있는 단위처럼 공존하는 소프트웨어 모델이 필요합니다.

Cell Coding defines those units as Cells with explicit role, membrane, and signal contracts.
Cell Coding은 그 단위를 role, membrane, signal 계약을 가진 Cell로 정의합니다.

Physical AI scenarios | Physical AI 시나리오

Cell Coding maps embodied systems into functional cell networks, not one monolithic controller.
Cell Coding은 구현체 시스템을 단일 거대 컨트롤러가 아니라 기능 세포 네트워크로 매핑합니다.

Start here: A1 → A2 → A3 → A4 PET → A5 Humanoid.
시작점: A1 → A2 → A3 → A4 PET → A5 Humanoid.

Spider robot | 거미 로봇

A spider robot ingests vision, hearing, tactile, and chemical context simultaneously, then produces locomotion patterns, web generation, and chemical actions — sensing and acting cells adapt to terrain rather than following a fixed pipeline.
거미 로봇은 시각·청각·촉각·화학적 맥락을 동시에 받아들이고, 보행 패턴·거미줄 생성·화학적 작동을 만들어냅니다. 감각·행동 세포가 고정 파이프라인이 아니라 지형에 적응합니다.

Reference · 레퍼런스: examples/spider-robot/ — 10 cells, 3 organs, nervous EventBus (SCENARIO.md).

Humanoid robot | 휴머노이드

A humanoid ingests vision, proprioception, balance, hand tactile, and speech context at once. Its actions span bipedal locomotion, grasping, gestures, facial expression, and speech — better modeled as cooperating organs (balance, manipulation, interaction) than one controller pipeline.
휴머노이드는 시각·고유수용감각·균형·손 촉각·음성 맥락을 동시에 처리합니다. 이족 보행, 파지, 제스처, 표정, 발화는 단일 컨트롤러가 아니라 균형·조작·상호작용 기관의 협업으로 표현하는 편이 적합합니다.

Reference · 레퍼런스: examples/humanoid-robot/ — 14 cells, 4 organs, nervous MotorBus (SCENARIO.md).

PET robot | 반려(PET) 로봇

A companion PET robot reads owner presence, touch, voice tone, and ambient home context continuously. Its behaviors include following, responsive vocalization, tail/LED expression, and comfort actions — modeled as affect and safety cells, not discrete I/O events.
반려(PET) 로봇은 주인 존재, 터치, 음성 톤, 가정 환경 맥락을 연속적으로 읽습니다. 따라가기, 반응형 발성, 꼬리/LED 표현, 위로 행동은 이산 I/O가 아니라 정서·안전 세포 네트워크로 모델링합니다.

Reference · 레퍼런스: examples/pet-robot/ — 11 cells, affect + safety + interaction (SCENARIO.md).

  • Cell: one specialized function | 단일 특화 기능
  • Tissue: cooperating cells for a local goal | 국소 목표를 위한 세포 협업
  • Organ: domain capability boundary | 도메인 기능 경계
  • Organism: full embodied system | 전체 구현 시스템

One-liner | 한 줄 정의

Decompose by role, declare boundaries with membrane, and connect systems through signal.
**역할(role)**로 분해하고, **막(membrane)**으로 경계를 선언하며, **신호(signal)**로 시스템을 연결한다.

Core concepts | 핵심 개념

  • Cell: minimal unit of execution, single responsibility
    Cell: 최소 실행 단위, 단일 책임
  • Membrane: functional boundary and signal contract
    Membrane: 기능 경계이자 신호 계약
  • Signal: the only communication primitive between cells
    Signal: 세포 간 유일한 통신 원시 단위
  • Tissue/Organ/Organism: scalable biological hierarchy
    Tissue/Organ/Organism: 확장 가능한 생물학적 계층
  • Nervous/Immune: routing and resilience policies
    Nervous/Immune: 라우팅 및 회복 탄력성 정책

Goals (v0.x) | 목표 (v0.x)

  1. Runtime first: working event bus + contract validation
    런타임 우선: 동작 가능한 이벤트 버스 + 계약 검증
  2. Observability: React Viewer for signal flow visualization
    관측 가능성: React Viewer 기반 신호 흐름 시각화
  3. Extensibility: Python bridge for sensors and actuators
    확장성: Python 브리지로 센서/액추에이터 연동
  4. Progressive DSL: optional .cell syntax later
    점진적 DSL: 이후 .cell 문법을 선택적으로 도입

Quick start | 빠른 시작

Requires Node.js 20+.

# Physical AI PoC — MotionDetected → AlarmPulse
npx @cell-coding/cli run ./motion-alarm.cell MotionDetected '{"x":150,"y":220,"confidence":0.98}'

# transpiled TS handlers
npx @cell-coding/cli run --transpiled ./validator.cell RawInput '{"payload":"hello"}'

# global install
npm install -g @cell-coding/cli
cell run ./motion-alarm.cell MotionDetected '{"x":1,"y":2,"confidence":0.9}'

From source: cd typescript && npm install && npm test — see examples/README.md.

Release: .github/RELEASE.md — push tag v* to publish npm · PyPI · VS Code extension.

Repository | 저장소

How to contribute | 기여 방법

  1. Check milestones in ROADMAP.en.md
    ROADMAP.en.md에서 마일스톤 확인
  2. Read OPEN_SOURCE_CHARTER.en.md
    OPEN_SOURCE_CHARTER.en.md에서 프로젝트 원칙 확인
  3. Start with issues labeled good first issue
    good first issue 라벨 작업부터 시작

See contributing.html (Pages) or CONTRIBUTING.en.md for details.
자세한 절차는 contributing.html (Pages) 또는 CONTRIBUTING.en.md 참고.

For security-sensitive findings, use SECURITY.md and report them privately instead of opening a public issue. The English summary there covers the reporting path, response targets, and severity guidance.

Documentation | 문서

Pages docs (EN/KR) GitHub Markdown
index.html README.en.md
concept-overview.html —
cell-coding.html —
language-specification.html —
roadmap.html ROADMAP.en.md
contributing.html CONTRIBUTING.en.md
— OPEN_SOURCE_CHARTER.en.md
SECURITY.md (Korean primary)
ISSUE_LABELS.md (Korean primary)
rfcs/README.md RFC process (Korean)
PRESENTATION_OUTLINE.md Launch deck outline (Korean)

Concept & specification (HTML)

License | 라이선스

Apache-2.0 — see LICENSE.
Apache-2.0 — LICENSE 참고.