ltcai 0.1.0__tar.gz

ltcai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TaeSoo Park
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ltcai-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: ltcai
+Version: 0.1.0
+Summary: Lattice AI local MLX/cloud LLM workspace server
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/TaeSooPark-PTS/LatticeAI
+Project-URL: Repository, https://github.com/TaeSooPark-PTS/LatticeAI
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi
+Requires-Dist: uvicorn
+Requires-Dist: pydantic
+Requires-Dist: httpx
+Requires-Dist: pillow
+Requires-Dist: openai
+Requires-Dist: python-docx
+Requires-Dist: openpyxl
+Requires-Dist: python-pptx
+Requires-Dist: python-multipart
+Requires-Dist: keyring
+Provides-Extra: local
+Requires-Dist: mlx-lm; extra == "local"
+Requires-Dist: mlx-vlm; extra == "local"
+Provides-Extra: voice
+Requires-Dist: openai-whisper; extra == "voice"
+Requires-Dist: SpeechRecognition; extra == "voice"
+Requires-Dist: pydub; extra == "voice"
+Provides-Extra: all
+Requires-Dist: mlx-lm; extra == "all"
+Requires-Dist: mlx-vlm; extra == "all"
+Requires-Dist: openai-whisper; extra == "all"
+Requires-Dist: SpeechRecognition; extra == "all"
+Requires-Dist: pydub; extra == "all"
+Dynamic: license-file
+
+# Lattice AI
+
+Local/cloud LLM workspace server with MLX, Ollama, vLLM, OpenAI-compatible providers,
+BYOK API keys, MCP recommendations, and editor extensions for VS Code, Cursor, and Antigravity.
+
+---
+
+## 아키텍처
+
+```
+Lattice AI/
+├── server.py              # FastAPI bridge server (port 4825)
+├── llm_router.py          # local/cloud model router
+├── tools.py               # local workspace tools
+├── static/                # web UI
+├── bin/ltcai.js           # npm CLI entrypoint
+├── pyproject.toml         # PyPI metadata
+└── vscode-extension/      # VS Code/Cursor/Antigravity extension
+```
+
+---
+
+## 빠른 시작
+
+### 1. 서버 설치 & 실행
+
+```bash
+# PyPI
+pip install ltcai
+
+# 로컬 MLX까지 함께 쓰려면
+pip install "ltcai[local]"
+
+# npm
+npm install -g ltcai
+
+# 서버 실행
+LTCAI
+# → http://localhost:4825 에서 실행됨
+```
+
+개발 중에는 설치 없이도 실행할 수 있습니다.
+
+```bash
+python ltcai_cli.py
+python ltcai_cli.py --reload
+LTCAI doctor
+```
+
+`npm install -g ltcai`로 설치한 경우 첫 실행 시 `~/.ltcai/npm-python`에 Python 가상환경을 만들고
+`requirements.txt`를 설치합니다. 자동 설치를 끄려면 `LTCAI_SKIP_NPM_BOOTSTRAP=1`을 설정하세요.
+
+Lattice AI stores runtime data in `~/.ltcai/` by default. Override it with
+`LATTICEAI_DATA_DIR=/path/to/data` when running `LTCAI`.
+
+### 2. 첫 모델 로드 (터미널 or 확장 프로그램에서)
+
+```bash
+# 터미널에서 직접
+curl -X POST http://localhost:4825/models/load \
+  -H "Content-Type: application/json" \
+  -d '{"model_id": "mlx-community/Qwen2.5-Coder-7B-Instruct-4bit"}'
+```
+
+또는 확장 프로그램에서 `Cmd+Shift+M` → 모델 선택
+
+### 3. 확장 프로그램 설치
+
+```bash
+cd vscode-extension
+npm install
+npm run build
+npm run package:vsix
+
+# VS Code / Cursor / Antigravity에서:
+# 1. Extensions 패널 → "..." → "Install from VSIX" 또는
+# 2. 로컬 CLI가 있으면:
+npm run install:all
+```
+
+---
+
+## 모델/비용 구조
+
+- Local LLM: MLX, Ollama, vLLM, LM Studio, llama.cpp
+- Cloud LLM: OpenAI, OpenRouter, Groq, Together, xAI 등 OpenAI-compatible provider
+- API 비용: 사용자가 본인 API key를 입력하는 BYOK 구조입니다. 사용자별 키로 호출되므로 키 소유자가 사용량을 부담합니다.
+- 초대 링크 게이트는 기본 비활성화되어 있습니다. 다시 켜려면 `LATTICEAI_INVITE_GATE_ENABLED=true`를 설정하세요.
+
+## 보안 기본값
+
+- 기본 서버 바인딩은 `127.0.0.1:4825`입니다. 같은 네트워크에서 접속하게 하려면 명시적으로 `LATTICEAI_HOST=0.0.0.0`을 설정하세요.
+- CORS는 기본적으로 localhost만 허용합니다. 네트워크 공개가 필요하면 `LATTICEAI_CORS_ALLOW_NETWORK=true`를 명시적으로 설정하세요.
+- 사용자 API key는 OS keyring/Keychain에 저장합니다. keyring을 사용할 수 없는 환경에서 평문 저장을 허용하려면 `LATTICEAI_ALLOW_PLAINTEXT_API_KEYS=true`를 직접 설정해야 합니다.
+- 히스토리 저장 전 API key/token/password 패턴은 마스킹됩니다.
+
+## 지원 모델 예시 (M5 32GB 기준)
+
+| 모델 | 용도 | 크기 | 추천도 |
+|------|------|------|--------|
+| `mlx-community/Qwen2.5-Coder-7B-Instruct-4bit`  | 코딩 | ~4GB  | ⭐⭐⭐ |
+| `mlx-community/Qwen2.5-Coder-14B-Instruct-4bit` | 코딩 | ~8GB  | ⭐⭐⭐⭐ |
+| `mlx-community/Qwen2.5-Coder-32B-Instruct-4bit` | 코딩 | ~18GB | ⭐⭐⭐⭐⭐ |
+| `mlx-community/Llama-3.1-8B-Instruct-4bit`      | 범용 | ~4.5GB| ⭐⭐⭐ |
+| `mlx-community/DeepSeek-R1-0528-4bit`           | 추론 | ~38GB | ⭐⭐⭐⭐ |
+| `mlx-community/Phi-4-4bit`                      | 코딩 | ~8GB  | ⭐⭐⭐⭐ |
+| `mlx-community/gemma-3-27b-it-4bit`             | 범용 | ~15GB | ⭐⭐⭐ |
+
+> **M5 32GB 추천**: Qwen2.5-Coder-32B-Instruct-4bit (18GB) — 32GB에서 여유롭게 동작
+
+---
+
+## 멀티모델 핫스왑
+
+여러 모델을 동시에 메모리에 올려두고 즉시 전환 가능:
+
+```bash
+# 모델 A 로드
+curl -X POST localhost:4825/models/load -d '{"model_id":"mlx-community/Qwen2.5-Coder-7B-Instruct-4bit"}'
+
+# 모델 B도 함께 로드
+curl -X POST localhost:4825/models/load -d '{"model_id":"mlx-community/Llama-3.1-8B-Instruct-4bit"}'
+
+# B → A 즉시 전환 (재로드 없음)
+curl -X POST localhost:4825/models/switch/mlx-community%2FQwen2.5-Coder-7B-Instruct-4bit
+
+# 메모리 해제
+curl -X DELETE localhost:4825/models/unload/mlx-community%2FLlama-3.1-8B-Instruct-4bit
+```
+
+---
+
+## 키보드 단축키
+
+| 단축키 | 기능 |
+|--------|------|
+| `Cmd+Shift+A` | 채팅 패널 열기 |
+| `Cmd+Shift+E` | 선택 코드 편집 (선택 필요) |
+| `Cmd+Shift+M` | 모델 로드 / 전환 |
+| 우클릭 메뉴 | Explain / Edit / Garden에 저장 |
+
+---
+
+## P-Reinforce 지식 정원사
+
+지식은 `~/.ltcai-ai-brain/`에 자동 분류 저장:
+
+```
+~/.ltcai-ai-brain/
+├── INDEX.md
+├── 00_Raw/       # 원시 데이터, 아이디어
+├── 10_Wiki/      # 검증된 개념, 레퍼런스
+├── 20_Skills/    # 코드 스니펫, 프롬프트
+├── 30_Projects/  # 프로젝트 컨텍스트
+└── 40_Log/       # 날짜별 작업 로그
+```
+
+사용법: 에디터에서 텍스트 선택 → 우클릭 → **"Save to Knowledge Garden"**
+
+---
+
+## API 엔드포인트
+
+| Method | Path | 설명 |
+|--------|------|------|
+| GET | `/health` | 서버 상태, 현재 모델 |
+| GET | `/models` | 추천 모델 목록 + 로드 상태 |
+| POST | `/models/load` | 모델 로드 (캐시 지원) |
+| POST | `/models/switch/{id}` | 활성 모델 전환 |
+| DELETE | `/models/unload/{id}` | 모델 언로드 |
+| POST | `/chat` | 생성 (stream=true/false) |
+| POST | `/garden` | P-Reinforce 저장 |
+| GET | `/garden/tree` | 지식 트리 조회 |
+
+---
+
+## 자동 시작 설정 (선택)
+
+```bash
+# launchd plist로 Mac 부팅시 자동 시작
+cat > ~/Library/LaunchAgents/com.ltcai.mlx.plist << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>com.ltcai.mlx</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/bin/python3</string>
+    <string>/path/to/LTCAI-ai-mlx/server/server.py</string>
+  </array>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+</dict>
+</plist>
+EOF
+
+launchctl load ~/Library/LaunchAgents/com.ltcai.mlx.plist
+```

ltcai-0.1.0/README.md

@@ -0,0 +1,199 @@
+# Lattice AI
+
+Local/cloud LLM workspace server with MLX, Ollama, vLLM, OpenAI-compatible providers,
+BYOK API keys, MCP recommendations, and editor extensions for VS Code, Cursor, and Antigravity.
+
+---
+
+## 아키텍처
+
+```
+Lattice AI/
+├── server.py              # FastAPI bridge server (port 4825)
+├── llm_router.py          # local/cloud model router
+├── tools.py               # local workspace tools
+├── static/                # web UI
+├── bin/ltcai.js           # npm CLI entrypoint
+├── pyproject.toml         # PyPI metadata
+└── vscode-extension/      # VS Code/Cursor/Antigravity extension
+```
+
+---
+
+## 빠른 시작
+
+### 1. 서버 설치 & 실행
+
+```bash
+# PyPI
+pip install ltcai
+
+# 로컬 MLX까지 함께 쓰려면
+pip install "ltcai[local]"
+
+# npm
+npm install -g ltcai
+
+# 서버 실행
+LTCAI
+# → http://localhost:4825 에서 실행됨
+```
+
+개발 중에는 설치 없이도 실행할 수 있습니다.
+
+```bash
+python ltcai_cli.py
+python ltcai_cli.py --reload
+LTCAI doctor
+```
+
+`npm install -g ltcai`로 설치한 경우 첫 실행 시 `~/.ltcai/npm-python`에 Python 가상환경을 만들고
+`requirements.txt`를 설치합니다. 자동 설치를 끄려면 `LTCAI_SKIP_NPM_BOOTSTRAP=1`을 설정하세요.
+
+Lattice AI stores runtime data in `~/.ltcai/` by default. Override it with
+`LATTICEAI_DATA_DIR=/path/to/data` when running `LTCAI`.
+
+### 2. 첫 모델 로드 (터미널 or 확장 프로그램에서)
+
+```bash
+# 터미널에서 직접
+curl -X POST http://localhost:4825/models/load \
+  -H "Content-Type: application/json" \
+  -d '{"model_id": "mlx-community/Qwen2.5-Coder-7B-Instruct-4bit"}'
+```
+
+또는 확장 프로그램에서 `Cmd+Shift+M` → 모델 선택
+
+### 3. 확장 프로그램 설치
+
+```bash
+cd vscode-extension
+npm install
+npm run build
+npm run package:vsix
+
+# VS Code / Cursor / Antigravity에서:
+# 1. Extensions 패널 → "..." → "Install from VSIX" 또는
+# 2. 로컬 CLI가 있으면:
+npm run install:all
+```
+
+---
+
+## 모델/비용 구조
+
+- Local LLM: MLX, Ollama, vLLM, LM Studio, llama.cpp
+- Cloud LLM: OpenAI, OpenRouter, Groq, Together, xAI 등 OpenAI-compatible provider
+- API 비용: 사용자가 본인 API key를 입력하는 BYOK 구조입니다. 사용자별 키로 호출되므로 키 소유자가 사용량을 부담합니다.
+- 초대 링크 게이트는 기본 비활성화되어 있습니다. 다시 켜려면 `LATTICEAI_INVITE_GATE_ENABLED=true`를 설정하세요.
+
+## 보안 기본값
+
+- 기본 서버 바인딩은 `127.0.0.1:4825`입니다. 같은 네트워크에서 접속하게 하려면 명시적으로 `LATTICEAI_HOST=0.0.0.0`을 설정하세요.
+- CORS는 기본적으로 localhost만 허용합니다. 네트워크 공개가 필요하면 `LATTICEAI_CORS_ALLOW_NETWORK=true`를 명시적으로 설정하세요.
+- 사용자 API key는 OS keyring/Keychain에 저장합니다. keyring을 사용할 수 없는 환경에서 평문 저장을 허용하려면 `LATTICEAI_ALLOW_PLAINTEXT_API_KEYS=true`를 직접 설정해야 합니다.
+- 히스토리 저장 전 API key/token/password 패턴은 마스킹됩니다.
+
+## 지원 모델 예시 (M5 32GB 기준)
+
+| 모델 | 용도 | 크기 | 추천도 |
+|------|------|------|--------|
+| `mlx-community/Qwen2.5-Coder-7B-Instruct-4bit`  | 코딩 | ~4GB  | ⭐⭐⭐ |
+| `mlx-community/Qwen2.5-Coder-14B-Instruct-4bit` | 코딩 | ~8GB  | ⭐⭐⭐⭐ |
+| `mlx-community/Qwen2.5-Coder-32B-Instruct-4bit` | 코딩 | ~18GB | ⭐⭐⭐⭐⭐ |
+| `mlx-community/Llama-3.1-8B-Instruct-4bit`      | 범용 | ~4.5GB| ⭐⭐⭐ |
+| `mlx-community/DeepSeek-R1-0528-4bit`           | 추론 | ~38GB | ⭐⭐⭐⭐ |
+| `mlx-community/Phi-4-4bit`                      | 코딩 | ~8GB  | ⭐⭐⭐⭐ |
+| `mlx-community/gemma-3-27b-it-4bit`             | 범용 | ~15GB | ⭐⭐⭐ |
+
+> **M5 32GB 추천**: Qwen2.5-Coder-32B-Instruct-4bit (18GB) — 32GB에서 여유롭게 동작
+
+---
+
+## 멀티모델 핫스왑
+
+여러 모델을 동시에 메모리에 올려두고 즉시 전환 가능:
+
+```bash
+# 모델 A 로드
+curl -X POST localhost:4825/models/load -d '{"model_id":"mlx-community/Qwen2.5-Coder-7B-Instruct-4bit"}'
+
+# 모델 B도 함께 로드
+curl -X POST localhost:4825/models/load -d '{"model_id":"mlx-community/Llama-3.1-8B-Instruct-4bit"}'
+
+# B → A 즉시 전환 (재로드 없음)
+curl -X POST localhost:4825/models/switch/mlx-community%2FQwen2.5-Coder-7B-Instruct-4bit
+
+# 메모리 해제
+curl -X DELETE localhost:4825/models/unload/mlx-community%2FLlama-3.1-8B-Instruct-4bit
+```
+
+---
+
+## 키보드 단축키
+
+| 단축키 | 기능 |
+|--------|------|
+| `Cmd+Shift+A` | 채팅 패널 열기 |
+| `Cmd+Shift+E` | 선택 코드 편집 (선택 필요) |
+| `Cmd+Shift+M` | 모델 로드 / 전환 |
+| 우클릭 메뉴 | Explain / Edit / Garden에 저장 |
+
+---
+
+## P-Reinforce 지식 정원사
+
+지식은 `~/.ltcai-ai-brain/`에 자동 분류 저장:
+
+```
+~/.ltcai-ai-brain/
+├── INDEX.md
+├── 00_Raw/       # 원시 데이터, 아이디어
+├── 10_Wiki/      # 검증된 개념, 레퍼런스
+├── 20_Skills/    # 코드 스니펫, 프롬프트
+├── 30_Projects/  # 프로젝트 컨텍스트
+└── 40_Log/       # 날짜별 작업 로그
+```
+
+사용법: 에디터에서 텍스트 선택 → 우클릭 → **"Save to Knowledge Garden"**
+
+---
+
+## API 엔드포인트
+
+| Method | Path | 설명 |
+|--------|------|------|
+| GET | `/health` | 서버 상태, 현재 모델 |
+| GET | `/models` | 추천 모델 목록 + 로드 상태 |
+| POST | `/models/load` | 모델 로드 (캐시 지원) |
+| POST | `/models/switch/{id}` | 활성 모델 전환 |
+| DELETE | `/models/unload/{id}` | 모델 언로드 |
+| POST | `/chat` | 생성 (stream=true/false) |
+| POST | `/garden` | P-Reinforce 저장 |
+| GET | `/garden/tree` | 지식 트리 조회 |
+
+---
+
+## 자동 시작 설정 (선택)
+
+```bash
+# launchd plist로 Mac 부팅시 자동 시작
+cat > ~/Library/LaunchAgents/com.ltcai.mlx.plist << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>com.ltcai.mlx</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/bin/python3</string>
+    <string>/path/to/LTCAI-ai-mlx/server/server.py</string>
+  </array>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+</dict>
+</plist>
+EOF
+
+launchctl load ~/Library/LaunchAgents/com.ltcai.mlx.plist
+```

ltcai-0.1.0/codex_telegram_bot.py

@@ -0,0 +1,191 @@
+import asyncio
+import json
+import logging
+import os
+from pathlib import Path
+
+import httpx
+from openai import AsyncOpenAI
+
+
+def load_env_file(path=".env"):
+    env_path = Path(path)
+    if not env_path.exists():
+        return
+    for raw_line in env_path.read_text(encoding="utf-8").splitlines():
+        line = raw_line.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, value = line.split("=", 1)
+        os.environ.setdefault(key.strip(), value.strip().strip('"').strip("'"))
+
+
+load_env_file()
+
+TELEGRAM_TOKEN = os.getenv("CODEX_TELEGRAM_BOT_TOKEN", "")
+TELEGRAM_API_URL = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}"
+OPENAI_MODEL = os.getenv("CODEX_OPENAI_MODEL", "gpt-5.4")
+STATE_FILE = Path(os.getenv("CODEX_TELEGRAM_STATE_FILE", "codex_telegram_state.json"))
+GITHUB_TOKEN = os.getenv("GITHUB_TOKEN", "")
+GITHUB_REPO = os.getenv("GITHUB_REPO", "")
+
+SYSTEM_PROMPT = """You are Lattice AI, the user's Codex development partner.
+Discuss architecture, implementation plans, code reviews, and GitHub-ready changes.
+Keep Korean responses concise and actionable.
+When the user asks for changes that should land in the repository, propose a clear patch plan.
+Use /issue to create GitHub issues when the user wants work tracked in git.
+Do not claim that local Mac files were changed unless a GitHub action or explicit repository operation completed."""
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("codex_telegram_bot")
+openai_client = AsyncOpenAI()
+
+
+def load_state():
+    if not STATE_FILE.exists():
+        return {}
+    try:
+        return json.loads(STATE_FILE.read_text(encoding="utf-8"))
+    except json.JSONDecodeError:
+        return {}
+
+
+def save_state(state):
+    STATE_FILE.write_text(json.dumps(state, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+async def send_message(client, chat_id, text):
+    chunks = [text[i:i + 3900] for i in range(0, len(text), 3900)] or [""]
+    for chunk in chunks:
+        await client.post(
+            f"{TELEGRAM_API_URL}/sendMessage",
+            json={"chat_id": chat_id, "text": chunk},
+            timeout=30,
+        )
+
+
+async def get_updates(client, offset=None):
+    params = {"timeout": 30}
+    if offset is not None:
+        params["offset"] = offset
+    try:
+        res = await client.get(f"{TELEGRAM_API_URL}/getUpdates", params=params, timeout=35)
+        return res.json()
+    except Exception as exc:
+        logger.error("Telegram update failed: %s", exc)
+        return None
+
+
+async def create_github_issue(title, body):
+    if not GITHUB_TOKEN or not GITHUB_REPO:
+        return "GITHUB_TOKEN 또는 GITHUB_REPO가 설정되지 않아 이슈를 만들 수 없습니다."
+
+    async with httpx.AsyncClient() as client:
+        res = await client.post(
+            f"https://api.github.com/repos/{GITHUB_REPO}/issues",
+            headers={
+                "Authorization": f"Bearer {GITHUB_TOKEN}",
+                "Accept": "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+            },
+            json={"title": title, "body": body},
+            timeout=30,
+        )
+
+    if res.status_code >= 300:
+        return f"GitHub 이슈 생성 실패 ({res.status_code}): {res.text[:1000]}"
+
+    data = res.json()
+    return f"GitHub 이슈 생성 완료: {data.get('html_url')}"
+
+
+async def ask_codex(chat_id, message):
+    state = load_state()
+    chat_key = str(chat_id)
+    previous_response_id = state.get(chat_key, {}).get("previous_response_id")
+
+    kwargs = {
+        "model": OPENAI_MODEL,
+        "instructions": SYSTEM_PROMPT,
+        "input": message,
+        "max_output_tokens": 1800,
+    }
+    if previous_response_id:
+        kwargs["previous_response_id"] = previous_response_id
+
+    response = await openai_client.responses.create(**kwargs)
+    state[chat_key] = {"previous_response_id": response.id}
+    save_state(state)
+    return response.output_text
+
+
+def parse_issue_command(text):
+    content = text[len("/issue"):].strip()
+    if not content:
+        return None, None
+    parts = content.split("\n", 1)
+    title = parts[0].strip()
+    body = parts[1].strip() if len(parts) > 1 else title
+    return title, body
+
+
+async def handle_message(client, chat_id, text):
+    if text == "/start":
+        await send_message(
+            client,
+            chat_id,
+            "Codex 전용 봇입니다.\n"
+            "- 일반 메시지: Codex와 개발 상담\n"
+            "- /reset: 이 대화 컨텍스트 초기화\n"
+            "- /issue 제목\\n내용: GitHub 이슈 생성",
+        )
+        return
+
+    if text == "/reset":
+        state = load_state()
+        state.pop(str(chat_id), None)
+        save_state(state)
+        await send_message(client, chat_id, "Codex 대화 컨텍스트를 초기화했습니다.")
+        return
+
+    if text.startswith("/issue"):
+        title, body = parse_issue_command(text)
+        if not title:
+            await send_message(client, chat_id, "사용법: /issue 제목\\n내용")
+            return
+        await send_message(client, chat_id, await create_github_issue(title, body))
+        return
+
+    await send_message(client, chat_id, "Codex가 검토 중입니다...")
+    try:
+        answer = await ask_codex(chat_id, text)
+    except Exception as exc:
+        logger.exception("OpenAI request failed")
+        answer = f"OpenAI 요청 실패: {exc}"
+    await send_message(client, chat_id, answer)
+
+
+async def run_bot():
+    if not TELEGRAM_TOKEN:
+        raise RuntimeError("CODEX_TELEGRAM_BOT_TOKEN is required.")
+    if not os.getenv("OPENAI_API_KEY"):
+        raise RuntimeError("OPENAI_API_KEY is required.")
+
+    logger.info("Codex Telegram bot started.")
+    last_update_id = None
+    async with httpx.AsyncClient() as client:
+        while True:
+            updates = await get_updates(client, last_update_id)
+            if updates and updates.get("ok"):
+                for update in updates.get("result", []):
+                    last_update_id = update["update_id"] + 1
+                    msg = update.get("message") or {}
+                    chat = msg.get("chat") or {}
+                    text = msg.get("text") or ""
+                    if chat.get("id") and text:
+                        asyncio.create_task(handle_message(client, chat["id"], text))
+            await asyncio.sleep(0.5)
+
+
+if __name__ == "__main__":
+    asyncio.run(run_bot())