Skip to content

Commit 402fe78

Browse files
committed
README: 다운로드-우선 hero + 빠른 시작 + 이름 유래·포지셔닝
- 상단 재구성: 런처 다운로드 배지 + 4단계 빠른 시작(다운로드 → 더블클릭 → 자동 설치 → 바로 학습) + 자동 구성 표. - 포지셔닝: 보조 지능 없이도 완전한 Python 공부·업무 자동화 커리큘럼, 원하면 지능형 추천 확장까지 겸비. - 이름 유래(코드 아로? 말장난) 한 줄. - 레슨 수 130+ → 460+(실제 463), 자체 업데이트·PyPI 미사용 안내.
1 parent 6324701 commit 402fe78

1 file changed

Lines changed: 61 additions & 22 deletions

File tree

README.md

Lines changed: 61 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,76 @@
1-
<p align="right">
2-
<a href="https://eddmpython.github.io/codaro/"><strong>eddmpython.github.io/codaro</strong></a>
3-
</p>
1+
<div align="center">
42

5-
# Codaro — 로컬 Python 학습·실행·자동화 스튜디오
3+
<img src="assets/brand/mascot/codaro-character.png" width="170" alt="Codaro 마스코트 — 로컬 Python 학습과 자동화를 잇는 개인 스튜디오 캐릭터" />
64

7-
<p align="center">
8-
<img src="assets/brand/mascot/codaro-character.png" width="170" alt="Codaro 마스코트 — 로컬 Python 학습과 자동화를 잇는 개인 스튜디오 캐릭터" />
5+
# Codaro
6+
7+
**AI 없이도 완전한 Python 공부 · 업무 자동화 커리큘럼 — 원하면 AI가 다음 확장을 추천합니다.**
8+
9+
코드가 인터페이스가 되는 개인 자동화 스튜디오. 전부 로컬에서, 더블클릭 한 번으로 시작합니다.
10+
11+
<sub><em>코다로(Codaro) — "코드 아로?" "코드 아로~" 코드와 친해지자는 말장난에서 시작한 이름입니다.</em></sub>
12+
13+
<p>
14+
<a href="https://github.com/eddmpython/codaro/releases/latest/download/CodaroLauncher.exe"><img alt="Download CodaroLauncher.exe" src="https://img.shields.io/badge/Download-CodaroLauncher.exe-2563eb?style=for-the-badge&labelColor=18181b&logo=windows&logoColor=white" /></a>
15+
<a href="https://github.com/eddmpython/codaro/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/eddmpython/codaro?style=for-the-badge&label=Release&labelColor=18181b&color=18181b&logo=github&logoColor=white" /></a>
16+
<a href="https://github.com/eddmpython/codaro/actions/workflows/product-release.yml"><img alt="Release build" src="https://img.shields.io/github/actions/workflow/status/eddmpython/codaro/product-release.yml?style=for-the-badge&label=Build&labelColor=18181b&logo=github&logoColor=white" /></a>
17+
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Non--Commercial_1.0-7c3aed?style=for-the-badge&labelColor=18181b" /></a>
918
</p>
1019

11-
<p align="center">
12-
<strong>코드가 인터페이스가 되는 개인 자동화 스튜디오.</strong><br/>
13-
<em>Reactive 노트북 · Percent Format · AI tool_use · 데스크톱 자동화 — 모두 로컬 Python 위에서.</em>
20+
<p>
21+
<img alt="Platform Windows 10/11" src="https://img.shields.io/badge/Platform-Windows_10%2F11-38bdf8?style=for-the-badge&labelColor=18181b&logo=windows&logoColor=white" />
22+
<img alt="Python 3.12+" src="https://img.shields.io/badge/Runtime-Python_3.12+-3776ab?style=for-the-badge&labelColor=18181b&logo=python&logoColor=white" />
23+
<img alt="Editor React 19" src="https://img.shields.io/badge/Editor-React_19-61dafb?style=for-the-badge&labelColor=18181b&logo=react&logoColor=white" />
24+
<img alt="Distribution GitHub Releases" src="https://img.shields.io/badge/Distribution-GitHub_Releases-18181b?style=for-the-badge&labelColor=18181b" />
1425
</p>
1526

16-
<p align="center">
17-
<a href="https://github.com/eddmpython/codaro/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/eddmpython/codaro?label=Release&color=18181b" /></a>
18-
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Non--Commercial_Source_1.0-7c3aed" /></a>
19-
<a href="https://www.python.org/"><img alt="Python 3.12+" src="https://img.shields.io/badge/Python-3.12+-3776ab?logo=python&logoColor=white" /></a>
20-
<a href="https://docs.astral.sh/uv/"><img alt="uv" src="https://img.shields.io/badge/Runtime-uv-de7c2c" /></a>
21-
<a href="https://react.dev/"><img alt="React 19" src="https://img.shields.io/badge/Editor-React_19-61dafb?logo=react&logoColor=white" /></a>
22-
<a href="https://eddmpython.github.io/codaro/"><img alt="GitHub Pages" src="https://img.shields.io/badge/Site-eddmpython.github.io%2Fcodaro-222" /></a>
23-
<a href="notebooks/python30DaysComplete/readme.md"><img alt="Python 30 Days" src="https://img.shields.io/badge/Python_30_Days-open-2563eb" /></a>
24-
<a href="https://colab.research.google.com/github/eddmpython/codaro/blob/main/notebooks/python30DaysComplete/colab/day01Helloworld.ipynb"><img alt="Open Day 01 in Colab" src="https://colab.research.google.com/assets/colab-badge.svg" /></a>
27+
<p>
28+
<a href="https://github.com/eddmpython/codaro/releases/latest/download/CodaroLauncher.exe"><strong>다운로드</strong></a> ·
29+
<a href="https://eddmpython.github.io/codaro/">문서</a> ·
30+
<a href="https://eddmpython.github.io/codaro/docs/blog">소식</a> ·
31+
<a href="https://github.com/eddmpython/codaro/issues">이슈</a>
2532
</p>
2633

34+
</div>
35+
2736
---
2837

2938
**Codaro**는 로컬 Python 위에서 **노트북 학습, reactive 코드 실행, 개인 데스크톱 자동화**를 하나의 문서 모델로 잇는 local-first programmable studio입니다. AST 분석으로 셀 의존성을 자동 추론하고, `# %%` percent format `.py`를 그대로 실행/공유하며, 검증된 셀은 스케줄·Webhook 트리거 가능한 태스크로 승격됩니다. AI는 선택적이고, 붙으면 제품 API를 `tool_use`로 호출해 셀 단위로 가르치고 검증합니다.
3039

3140
> **한 줄로** — 그냥 Python을 쓰면, 엔진이 셀 격리·의존 추적·재실행을 자동으로 합니다. 같은 셀이 학습 카드가 되고, 같은 `.py`가 자동화 태스크가 됩니다.
3241
42+
## 다운로드 & 빠른 시작
43+
44+
**비개발자도 더블클릭이면 끝.** 시스템 Python·uv·설정 전부 필요 없습니다 — 런처가 전부 자동으로 처리합니다.
45+
46+
<p align="center">
47+
<a href="https://github.com/eddmpython/codaro/releases/latest/download/CodaroLauncher.exe"><img alt="Download CodaroLauncher.exe" src="https://img.shields.io/badge/Windows_다운로드-CodaroLauncher.exe-2563eb?style=for-the-badge&labelColor=18181b&logo=windows&logoColor=white" /></a>
48+
</p>
49+
50+
1. **[CodaroLauncher.exe 다운로드](https://github.com/eddmpython/codaro/releases/latest/download/CodaroLauncher.exe)** _(Windows 10/11)_
51+
2. 받은 파일을 **더블클릭**합니다.
52+
3. 첫 실행에서 런처가 자동으로 — 관리형 Python runtime + `codaro` 본체 + **기본 커리큘럼(463 레슨)** 을 내려받아 설치합니다. (네트워크/디스크에 따라 몇 분)
53+
4. 준비가 끝나면 로컬 에디터(`http://127.0.0.1:8765`)로 자동 전환 — **커리큘럼 카드에서 바로 학습을 시작**합니다.
54+
55+
> 시스템에 Python이 없어도 됩니다. 런처가 격리된 관리형 런타임을 따로 설치하므로 기존 환경을 건드리지 않습니다.
56+
57+
**AI는 없어도 완전합니다.** 463개 커리큘럼 레슨과 업무 자동화는 AI 없이 그대로 동작하고, AI provider(GPT · Claude · Ollama)를 꽂으면 *다음에 배울 것·만들 것*을 추천하고 셀 단위로 확장해 줍니다.
58+
59+
### 첫 실행에서 자동 구성되는 것
60+
61+
| 구성 요소 | 역할 |
62+
|---|---|
63+
| 관리형 Python 3.12 runtime | 시스템 Python과 분리된 격리 실행 환경 |
64+
| `codaro` wheel | 에디터(React) · 실행 엔진 · **기본 커리큘럼(463 레슨)** 포함 |
65+
| `release-manifest.json` | 정확한 wheel·runtime 버전을 핀. 런처가 같은 경로로 업데이트를 확인 |
66+
67+
- **모두 자동, 자체 업데이트** — 런처는 실행할 때마다 본체 릴리스와 *런처 자신의 새 버전*을 확인해 갱신합니다.
68+
- **PyPI 미사용** — 배포는 오직 GitHub Releases manifest가 핀한 wheel로만 이뤄집니다.
69+
- **macOS / Linux** — 데스크톱 런처는 Windows 우선입니다. 다른 OS는 아래 [개발자 — 저장소에서 바로](#개발자--저장소에서-바로)로 동일 기능을 사용하세요.
70+
3371
## 목차
3472

73+
- [다운로드 & 빠른 시작](#다운로드--빠른-시작)
3574
- [Codaro는 무엇이 다른가](#codaro는-무엇이-다른가)
3675
- [Codaro vs Jupyter · marimo · Streamlit · ipynb](#codaro-vs-jupyter--marimo--streamlit--ipynb)
3776
- [어떤 사람에게 맞는가 — Use cases](#어떤-사람에게-맞는가--use-cases)
@@ -75,7 +114,7 @@
75114
| **AI 셀 단위 tool_use** | ✅ 기본 | ⚠ 확장 |||
76115
| **자동화 태스크 승격** | ✅ 스케줄·Webhook·DAG·E-Stop ||||
77116
| **데스크톱 자동화** | ✅ Vision/Voice/Input ||||
78-
| **학습 커리큘럼 1급** |130+ YAML 레슨 ||||
117+
| **학습 커리큘럼 1급** |460+ YAML 레슨 ||||
79118
| **외부 서버 마운트** | ✅ FastAPI/Django/Flask ||||
80119
| **라이선스** | Non-Commercial Source 1.0 | BSD | Apache 2.0 | Apache 2.0 |
81120

@@ -85,7 +124,7 @@
85124

86125
| 사용자 | 무엇을 얻나 |
87126
|---|---|
88-
| **Python 학습자** | YAML 130+ 레슨을 카테고리 트리로 탐색. 예측 → 실행 → 오류 → 검증 → 변주 흐름이 한 카드 안에서 끊기지 않음. |
127+
| **Python 학습자** | YAML 460+ 레슨을 카테고리 트리로 탐색. 예측 → 실행 → 오류 → 검증 → 변주 흐름이 한 카드 안에서 끊기지 않음. |
89128
| **데이터 분석가** | pandas/polars/duckdb 셀이 reactive로 묶여 입력 바꾸면 하위 계산이 자동 재실행. 검증된 분석은 매일 돌아가는 태스크로 승격. |
90129
| **반복 업무가 많은 직장인** | "매주 CSV 정리 → 리포트 → Slack 알림"을 셀 조합으로 만들고 `@every_5m` 스케줄로 등록. E-Stop으로 즉시 중단. |
91130
| **데스크톱 자동화 개발자** | Vision(OCR/템플릿 매칭) + Input(PyAutoGUI + InputGuard)으로 GUI 자동화 스크립트를 녹화 → Python으로 변환. |
@@ -153,7 +192,7 @@ Codaro의 제품 폴더는 [`editor/`](editor/)이고, 사용자에게 보이는
153192
## 학습 시스템 — 3기둥
154193

155194
- **기둥 1 — 노트북 기능**: 셀 편집/실행/리액티브 그대로가 학습 환경.
156-
- **기둥 2 — 뼈대 커리큘럼**: `curricula/` YAML 130+ 레슨, 카테고리 트리로 진입.
195+
- **기둥 2 — 뼈대 커리큘럼**: `curricula/` YAML 460+ 레슨, 카테고리 트리로 진입.
157196
- **기둥 3 — 학습 사상**: 코드로 정의된 교육 철학. AI도 사람도 따른다.
158197
- 최소 설명·최대 실행 · 빈칸부터 시작 · 예측 → 검증 · 오류로 배우기 · 점진적 빌드
159198
- 수정 실험 · 3단계 힌트 · 즉시 피드백 · 반복 변주 · 실제 맥락
@@ -294,7 +333,7 @@ uv run python -X utf8 demos/publicLaunch/fileOrganizerDemo.py
294333
codaro/
295334
├── src/codaro/ # Python 패키지 (engine / kernel / runtime / curriculum / ai / automation / api ...)
296335
├── editor/ # 제품 UI (React 19 + Vite + CodeMirror + Tailwind)
297-
├── curricula/ # 기본 학습 자산 YAML (130+ 레슨)
336+
├── curricula/ # 기본 학습 자산 YAML (460+ 레슨)
298337
├── notebooks/ # curricula에서 파생된 배포용 노트북
299338
├── demos/ # 공개 데모 + 5분 quickstart
300339
├── launcher/ # 데스크톱 런처 + 업데이터

0 commit comments

Comments
 (0)