ProgramGarden Core
ProgramGarden은 AI 시대에 맞춰 파이썬을 모르는 투자자도 개인화된 시스템 트레이딩을 자동으로 수행할 수 있게 돕는 오픈소스입니다. 본 저장소는 노드 기반 DSL의 핵심 타입, 베이스 클래스, 레지스트리, i18n을 정의하는 "코어" 모듈입니다.
- 문서(비개발자 빠른 시작): https://programgarden.gitbook.io/docs/invest/non_dev_quick_guide
- 문서(개발자 구조 안내): https://programgarden.gitbook.io/docs/develop/structure
- 유튜브: https://www.youtube.com/@programgarden
- 실시간소통 오픈톡방: https://open.kakao.com/o/gKVObqUh
주요 특징
- 노드 기반 DSL: 73 core nodes를 조합하여 워크플로우를 정의하는 도메인 특화 언어
- 타입 안전한 스키마: Pydantic 모델 기반의 FieldSchema, 입출력 포트 정의로 IDE 친화적이고 안전한 개발
- 레지스트리 시스템: NodeTypeRegistry와 PluginRegistry로 노드/플러그인 메타데이터 관리
- 다국어 지원(i18n): 한국어/영어 번역 파일을 통한 노드 설명, 필드명 자동 번역
- 상품별 분리: 해외주식(
overseas_stock)과 해외선물(overseas_futures)을 독립된 노드로 지원 - 플러그인 확장: ConditionNode에 커뮤니티 전략 플러그인(RSI, MACD 등)을 연결하여 확장
설치
pip install programgarden-core
# Poetry 사용 시 (개발 환경)
poetry add programgarden-core
요구 사항: Python 3.12+
Node categories (11 categories, 73 core nodes)
| 카테고리 | 노드 수 | 대표 노드 |
|---|---|---|
| infra | 8 | StartNode, BrokerNode, ThrottleNode, SplitNode, AggregateNode, IfNode, KoreaStockBrokerNode |
| account | 13 | AccountNode, OpenOrdersNode, RealAccountNode, RealOrderEventNode (해외주식/선물 + 국내주식) |
| market | 22 | MarketDataNode, HistoricalDataNode, RealMarketDataNode, WatchlistNode, ExclusionListNode, CurrencyRateNode, KoreaStock* |
| condition | 2 | ConditionNode, LogicNode |
| order | 10 | NewOrderNode, ModifyOrderNode, CancelOrderNode, PositionSizingNode (해외주식/선물 + 국내주식) |
| risk | 1 | PortfolioNode |
| schedule | 3 | ScheduleNode, TradingHoursFilterNode, SessionGateNode |
| data | 4 | SQLiteNode, HTTPRequestNode, FieldMappingNode, CodeNode |
| display | 6 | TableDisplayNode, LineChartNode, CandlestickChartNode, SummaryDisplayNode |
| analysis | 2 | BacktestEngineNode, BenchmarkCompareNode |
| ai | 2 | LLMModelNode, AIAgentNode |
Community adds five nodes: TelegramNode, FearGreedIndexNode, FundamentalDataNode, FileReaderNode and PerformanceReportNode, for 78 total.
사용 예시
from programgarden_core import (
# 노드
StartNode, ConditionNode, LogicNode,
OverseasStockBrokerNode, OverseasStockAccountNode,
# 모델
Edge, WorkflowDefinition, WorkflowJob, JobState,
# 레지스트리
NodeTypeRegistry, PluginRegistry,
)
# 레지스트리에서 노드 스키마 조회
registry = NodeTypeRegistry()
schema = registry.get_schema("OverseasStockBrokerNode")
print(schema.config_schema)
패키지 구조
programgarden_core/
├── nodes/ # 73 core node definitions
├── bases/ # Finance 베이스 클래스
├── models/ # Pydantic 모델 (FieldSchema, Edge, WorkflowDefinition 등)
├── registry/ # NodeTypeRegistry, PluginRegistry
├── i18n/locales/ # 번역 파일 (ko.json, en.json)
└── exceptions/ # DSL/Finance 예외 클래스
기여하기
이슈/토론/PR 환영합니다. 버그 리포트 시 재현 단계와 최소 예시를 함께 제공해 주시면 빠르게 대응할 수 있습니다.
변경 로그
자세한 변경 사항은 CHANGELOG.md를 참고하세요.
Workflow PnL event contract
Futures workflow PnL events preserve native gross estimates separately from
accounting results. workflow_*, other_*, total_*, account and competition
monetary/rate scalars remain null when accounting evidence is unavailable.
pnl_by_currency contains gross price-change subtotals by contract currency;
monetary_positions retains their basis/status and unmodified, unconfirmed
broker_pnl_amount. No fee, FX, margin/equity return or verified contest score
is inferred from these estimates. Actual zero and negative amounts are retained.
currency is null for mixed or unavailable currencies. Consumers must handle
nullable monetary fields and must not coerce them to zero.
WorkflowPnLEvent.personal_metrics is an optional versioned envelope for retained
local workflow executions. Version 1 includes scope (kind, product, provider,
trading mode), timezone-aware as_of, basis, executed-order count/status,
per-symbol/exchange/currency realized amounts/status, and unavailable MDD.
It is unverified personal evidence, independent of whole-account contest results.
Stock realized amounts are stored long-only FIFO gross values excluding fees;
unknown currency stays null. Futures monetary values and portfolio MDD require
accounting evidence absent from this ledger and remain null. Consumers must
preserve null/status and use the latest cumulative observation, not sum dates.
Workflow account boundary
Each workflow allows one account and one product through at most one broker
connection. Additional connections produce DUPLICATE_BROKER_NODE, including
unbound or cross-product nodes. Reuse one broker for all consumers. Account-free
workflows and unrelated credentials remain supported. See
the shared contract.
Cancellation result contract (unreleased P4)
CancelOrder metadata describes request acknowledgement (accepted,
confirmation_pending=true), not final cancellation. Replacement orders require
separate matching completion evidence. See
the cancellation contract.
Session windows and IfNode routing inside Split are described in Session gates and guarded Split.
1 maintainer
Release files for programgarden-core 1.31.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| programgarden_core-1.31.1.tar.gz | 371.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| programgarden_core-1.31.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 828.6 kB
Release files / programgarden_core-1.31.1.tar.gz
| Download URL | programgarden_core-1.31.1.tar.gz |
|---|---|
| Size | 371.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4360881757b2725d48ae509fba3e778db5418eacb49844c1aa52b9ccc42075ff
|
|
BLAKE2b-256 checksum How to use checksums |
736b062a077a4fea415446632f17462b143d0e908e403842230e0b8c49282bdf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.13 Darwin/25.6.0
|
Release files / programgarden_core-1.31.1-py3-none-any.whl
| Download URL | programgarden_core-1.31.1-py3-none-any.whl |
|---|---|
| Size | 457.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b61ec20c6584d34da97418e437d7960f5b4cad6a75ec88dd92a1f294a66add05
|
|
BLAKE2b-256 checksum How to use checksums |
9f3a19910efb371535e3061fc2ed5bb97d7e92902733a839c779064dbba7ca83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.12.13 Darwin/25.6.0
|
