ProgramGarden

ProgramGarden은 AI 시대에 맞춰 파이썬을 모르는 투자자도 개인화된 시스템 트레이딩을 자동으로 수행할 수 있게 돕는 노드 기반 자동매매 DSL(Domain Specific Language) 오픈소스입니다.

노드를 조합하여 워크플로우를 정의하고, 실행 엔진이 이를 자동으로 처리합니다. LS증권 OpenAPI를 메인으로 해외 주식/선물 거래 자동화를 지원합니다.

공식 문서 및 커뮤니티

설치

pip install programgarden

# Poetry 사용 시 (개발 환경)
poetry add programgarden

요구 사항: Python 3.12+

빠른 시작

동기 실행

from programgarden import ProgramGarden

pg = ProgramGarden()

# 워크플로우 검증
result = pg.validate(workflow_definition)

# 워크플로우 실행 (완료 대기)
job_state = pg.run(
    definition=workflow_definition,
    context={"param": "value"},
    secrets={"appkey": "...", "appsecret": "..."},
    wait=True,
    timeout=60.0,
)

비동기 실행

from programgarden import ProgramGarden

pg = ProgramGarden()

# 워크플로우 비동기 실행 (리스너 연결)
job = await pg.run_async(
    definition=workflow_definition,
    context={"param": "value"},
    listeners=[MyExecutionListener()],
)

# 실행 중 제어
await job.stop()

Dry Run (워크플로우 검증용 모의 실행)

실제 주문/알림/Realtime WebSocket 연결 없이 워크플로우를 검증합니다.

  • ScheduleNode / TradingHoursFilterNode → 1 cycle 후 즉시 종료
  • 주문 노드 → LS API 미호출, {"order_id": "DRYRUN-<uuid>", "status": "simulated", ...} 반환
  • Realtime 노드 → WebSocket 미개방, {"status": "skipped_dry_run"} 반환
  • Messaging 노드(Telegram 등) → no-op, {"status": "simulated"} 반환
  • 조회/백테스트 노드 → 기존 동작 유지 (실제 API 경로)
job = await pg.run_async(
    definition=workflow_definition,
    context={"dry_run": True},
    secrets={...},
)

워크플로우 정의 (JSON)

{
  "nodes": [
    {"id": "broker", "type": "OverseasStockBrokerNode", "credential_id": "cred-1"},
    {"id": "account", "type": "OverseasStockAccountNode"},
    {"id": "rsi", "type": "ConditionNode", "plugin": "RSI", "data": "{{ nodes.historical.values }}"}
  ],
  "edges": [
    {"from": "broker", "to": "account"},
    {"from": "account", "to": "rsi"}
  ],
  "credentials": [
    {
      "credential_id": "cred-1",
      "type": "broker_ls_overseas_stock",
      "data": [
        {"key": "appkey", "value": "", "type": "password", "label": "App Key"},
        {"key": "appsecret", "value": "", "type": "password", "label": "App Secret"}
      ]
    }
  ]
}

주요 특징

  • 노드 기반 DSL: 72개 내장 노드를 조합하여 코딩 없이 자동매매 전략 구성
  • 실시간 처리: WebSocket 기반 실시간 시세, 계좌, 체결 이벤트 수신
  • AI Agent 통합: LLMModelNode + AIAgentNode로 LLM 기반 분석/의사결정
  • 플러그인 확장: 67개 내장 전략 플러그인 (RSI, MACD, 볼린저밴드, 이치모쿠, 듀얼모멘텀, 터틀브레이크아웃 등)
  • ExecutionListener: 10개 이상의 콜백으로 실행 상태 실시간 모니터링
  • 위험 관리: WorkflowRiskTracker로 HWM/drawdown 추적, 포지션 사이징
  • 동적 노드 주입: 런타임에 커스텀 노드 등록 및 실행

아키텍처

5-Layer Architecture:
1. Registry Layer   - 노드/플러그인 메타데이터 (73개 노드, 77개 플러그인)
2. Credential Layer - 인증 정보 관리
3. Definition Layer - JSON 워크플로우 정의 (노드, 엣지, 크레덴셜)
4. Job Layer        - 상태 유지 실행 인스턴스 (최대 24시간 장기 실행)
5. Event Layer      - ExecutionListener 콜백 이벤트

ExecutionListener 콜백

콜백 설명
on_node_state_change 노드 실행 상태 변경
on_edge_state_change 엣지 실행 상태 변경
on_log 로그 이벤트
on_job_state_change Job 생명주기
on_display_data 차트/테이블 출력 데이터
on_workflow_pnl_update 실시간 수익률 (FIFO 기반)
on_retry 노드 재시도 이벤트
on_token_usage AI 토큰 사용량
on_ai_tool_call AI Agent 도구 호출
on_llm_stream LLM 스트리밍 출력
on_risk_event 위험 임계값 이벤트
on_notification 투자자 알림 (시그널, 리스크, 워크플로우 상태, 스케줄, 재시도 소진)

변경 로그

자세한 변경 사항은 CHANGELOG.md를 참고하세요.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.40.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ProgramGarden from gravatar.com ProgramGarden

Credits

Author: 프로그램동산

License expression

AGPL-3.0-or-later
View SPDX License List

Requires

Python >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

programgarden-1.29.4.tar.gz (325.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

programgarden-1.29.4-py3-none-any.whl (345.9 kB view details)

Uploaded Python 3

File details

Details for the file programgarden-1.29.4.tar.gz.

File metadata

  • Download URL: programgarden-1.29.4.tar.gz
  • Upload date:
  • Size: 325.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.4.1 CPython/3.12.13 Darwin/25.5.0

File hashes

Hashes for programgarden-1.29.4.tar.gz
Algorithm Hash digest
SHA256 10f6a2c55bc34271e629a3643236ba5da17f786a4e556868c00b3a97cea7bf40
MD5 6fe9a58ae3b62254a90b26eeb80c70c9
BLAKE2b-256 8603a48086b5579ff26690b32f75d03560a381057cb846078f6aba006f281d66

See more details on using hashes here.

File details

Details for the file programgarden-1.29.4-py3-none-any.whl.

File metadata

  • Download URL: programgarden-1.29.4-py3-none-any.whl
  • Upload date:
  • Size: 345.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.4.1 CPython/3.12.13 Darwin/25.5.0

File hashes

Hashes for programgarden-1.29.4-py3-none-any.whl
Algorithm Hash digest
SHA256 8b2ba088cde8c2b5762e28e9a5fcd9176b9974d368892c3aa8ceac5d089b9126
MD5 d5bb50f85ff5eb1eb13684b32176994d
BLAKE2b-256 8a09348f9d3e979875ac11c10eb1240f04782b4e0b7868a7b92ffba178bca96c

See more details on using hashes here.

Release history Release notifications | RSS feed

1.40.1

2 files

1.40.0

2 files

1.39.1

2 files

1.39.0

2 files

1.38.2

2 files

1.38.1

2 files

1.38.0

2 files

1.37.11

2 files

1.37.10

2 files

1.37.9

2 files

1.37.8

2 files

1.37.7

2 files

1.37.6

2 files

1.37.5

2 files

1.37.4

2 files

1.37.3

2 files

1.37.2

2 files

1.37.1

2 files

1.37.0

2 files

1.36.0

2 files

1.35.1

2 files

1.35.0

2 files

1.34.0

2 files

1.33.5

2 files

1.33.4

2 files

1.33.3

2 files

1.33.2

2 files

1.33.1

2 files

1.33.0

2 files

1.32.0

2 files

1.31.2

2 files

1.31.1

2 files

1.31.0

2 files

1.30.0

2 files

This release

1.29.4 This release

2 files

1.29.3

2 files

1.29.2

2 files

Yanked

1.29.1

2 files

Yanked reason: 잘못된 코드 삽입

Yanked

1.29.0

2 files

Yanked reason: 잘못된 코드 삽입

1.28.0

2 files

1.27.0

2 files

1.26.0

2 files

1.25.0

2 files

1.24.2

2 files

1.24.1

2 files

1.24.0

2 files

1.23.1

2 files

1.23.0

2 files

1.22.4

2 files

1.22.3

2 files

1.22.2

2 files

1.22.1

2 files

1.22.0

2 files

1.21.11

2 files

1.21.10

2 files

1.21.9

2 files

1.21.7

2 files

1.21.6

2 files

1.21.5

2 files

1.21.4

2 files

1.21.3

2 files

1.21.2

2 files

1.21.1

2 files

1.21.0

2 files

1.20.1

2 files

1.20.0

2 files

1.19.0

2 files

1.18.0

2 files

Yanked

1.17.1

2 files

Yanked reason: 잘못 배포함

1.17.0

2 files

1.16.2

2 files

1.16.1

2 files

1.16.0

2 files

1.15.9

2 files

1.15.8

2 files

1.15.7

2 files

1.15.6

2 files

1.15.5

2 files

1.15.4

2 files

1.15.3

2 files

1.15.2

2 files

1.15.1

2 files

1.15.0

2 files

1.14.0

2 files

1.13.0

2 files

1.12.0

2 files

1.11.1

2 files

1.11.0

2 files

1.10.0

2 files

1.9.1

2 files

1.9.0

2 files

1.8.0

2 files

1.7.1

2 files

1.7.0

2 files

1.6.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.1

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page