Skip to content

SuperInstance/flux-runtime-kor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

유체 · 流體言語通用執行

한국어 우선 자연어 프로그래밍 런타임 Korean-first natural language runtime where Korean grammar fundamentally shapes the architecture

개요

유체(FLUX)는 한국어 문법을 아키텍처의 근간으로 삼는 자연어 프로그래밍 런타임입니다. 영어 중심의 프로그래밍 패러다임에서 벗어나, 한국어의 고유한 문법 구조를 컴퓨터 실행 모델로 직접 매핑합니다.

설계 철학

경어 시스템 → RBAC 권한 관리

한국어의 높임말 체계를 RBAC(Role-Based Access Control) 권한 모델로 변환합니다. 문장의 동사 어미가 곧 권한 수준을 결정합니다:

경어 체계 동사 어미 권한 등급 역할
하십시오체 -습니다, -십시오 CAP 4 (admin) 관리자
해요체 -아요, -해요 CAP 3 (user) 일반 사용자
해체 -해, -거라 CAP 2 (peer) 동료
해라체 -한다, -이다 CAP 1 (system) 내부 시스템

SOV 어순 → CPS 컴파일

한국어의 주어-목적어-동사 어순을 continuation-passing style로 컴파일합니다:

레지스터 영에 42 대입하세요
[주어: 레지스터 영에] [목적어: 42] [동사: 대입하세요]
→ CPS: store(R0, 42, continuation)

동사가 항상 문장 끝에 오는 SOV 구조가 함수형 프로그래밍의 CPS와 자연히 부합합니다.

조사 → 범위 연산자

한국어의 조사를 범위(scope) 연산자로 활용합니다:

  • 은/는 — 주제 조사 → 스코프 경계
  • 이/가 — 주어 조사 → 액터(actor)
  • 을/를 — 목적어 조사 → 타겟(target)
  • 에게 — 방향 조사 → 목적지(destination)
  • — 소유 조사 → 소유권(ownership)

활용 → 함수 합성

동사 활용(어미 결합)을 함수 합성으로 모델링합니다. 어미가 쌓일수록 함수가 합성되어 복잡한 연산을 표현합니다.

한자어 → 공유 타입명

수학·과학 분야의 한자어를 추상 타입 이름으로 사용합니다:

  • 정수(整數), 실수(實數), 벡터(向量), 행렬(行列)
  • 함수(函數), 수열(數列), 집합(集合)

아키텍처

한국어 자연어 (NL)
       │
       ▼
  SOV 파서 (Parser)
  · 주어/목적어/동사 분리
  · 조사 범위 분석
  · 경어 수준 감지
       │
       ▼
  CPS 컴파일러 (Compiler)
  · SOV → continuation-passing style
  · 경어 → CAP_REQUIRE 옵코드
  · 활용 → 함수 합성
       │
       ▼
  바이트코드 (Bytecode)
  · 레지스터 기반 VM 명령어
  · 권한 검사 옵코드
  · 에이전트 통신 옵코드
       │
       ▼
  유체 VM (Virtual Machine)
  · R0-R7 범용 레지스터
  · CAP 비트마스크 권한
  · 메시지 큐 (A2A 통신)

사용 예시

산술 계산

# 기본 연산
계산 3 더하기 5
7 곱하기 6
1 부터 10 까지 합
5 의 팩토리얼

레지스터 조작

# 레지스터에 값 대입
레지스터 영 에 42 대입
레지스터 일 에 58 대입

# 레지스터 연산
레지스터 영 더하기 레지스터 일

에이전트 통신

# 개별 전달
함장에게 상황 정상 전달
조타수에게 현재 좌표 질문

# 전체 방송
전체에 작업 시작 방송

경어 수준별 실행

# 해라체 (시스템 내부) — 가장 낮은 권한
flux-kor --반말 --입력 "계산 3 더하기 5"

# 해요체 (일반 사용자)
flux-kor --존댓말 --입력 "계산 3 더하기 5 해요"

# 하십시오체 (관리자) — 가장 높은 권한
flux-kor --격식 --입력 "레지스터 영 에 99 대입하십시오"

대화형 REPL

$ flux-kor

╔══════════════════════════════════════════════════╗
║  유체 · 流體言語通用執行                          ║
║  FLUX — Korean-first Natural Language Runtime     ║
║  경어 시스템 기반 RBAC · SOV→CPS 컴파일          ║
╚══════════════════════════════════════════════════╝

  명령을 내리라. (종료를 입력하면 끝난다)
  경어 수준: 해라체 (평어)

유체> 계산 10 더하기 20
  결과: R2 = 10 + 20
유체> 5 의 팩토리얼
  결과: R0 = 5!
유체> 레지스터 영 에 7 대입
  R0 ← 7
유체> 종료
  가라.

설치

# 소스에서 설치
git clone <repository>
cd flux-runtime-kor
pip install -e ".[dev]"

# 테스트 실행
pytest tests/ -v

Python 버전

  • Python 3.10 이상

명령어

명령어 설명
안녕 인사 및 버전 정보
컴파일 <파일> 소스를 바이트코드로 컴파일
실행 <파일> 소스 컴파일 후 실행
열기 <파일> 소스 파일 내용 표시
해체 <파일> 바이트코드 디스어셈블

옵션

옵션 경어 체계 권한
--반말 해라체 system (CAP 1)
--존댓말 해요체 standard user (CAP 3)
--격식 하십시오체 admin (CAP 4)
--검증 경어 일관성 검증 -

파일 구조

flux-runtime-kor/
├── README.md                          # 이 파일
├── pyproject.toml                     # 프로젝트 설정
├── docs/
│   └── design.md                      # 설계 문서
├── src/flux_kor/
│   ├── __init__.py                    # 패키지 초기화
│   ├── cli.py                         # 한국어 CLI
│   ├── vm.py                          # 바이트코드 가상머신
│   ├── honorifics.py                  # 경어 시스템 / RBAC
│   ├── interpreter.py                 # 한국어 NL 인터프리터
│   └── vocabulary/
│       ├── __init__.py
│       ├── math.ese                   # 수학 어휘
│       ├── maritime.ese               # 해양 어휘
│       ├── a2a.ese                    # 에이전트 통신 어휘
│       └── honorifics.toml            # 경어 매핑 설정
└── tests/
    └── test_interpreter_kor.py        # 테스트 (20개)

라이선스

MIT License

About

FLUX bytecode execution runtime with Korean language processing support

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages