AIM-Forge

비주얼 플로우 기반의 Python IDE - 노드를 연결하여 코드를 시각적으로 실행하고, Language Server Protocol(LSP)을 통해 VS Code 수준의 개발 경험을 제공합니다.

🚀 Quick Start

로컬 개발 (권장)

# pnpm 설치
npm install -g pnpm

# 의존성 설치
pnpm install

# 개발 서버 실행
pnpm dev

# Network: http://XXX.XXX.XX.XXX:5173/ 접속

Docker로 실행 (준비 중)

# 개발 모드
docker-compose -f docker-compose.dev.yml up --build

# 프로덕션 모드  
docker-compose -f docker-compose.prod.yml up --build

📦 패키지 관리

프로젝트별로 독립된 Python 가상환경이 자동 생성됩니다. UI에서 패키지를 관리하려면 다음 단계를 따르세요.

1. 프로젝트 화면의 왼쪽 Project Panel에서 Packages 버튼을 클릭해 패널을 펼칩니다.
2. 설치할 패키지 이름(예: requests 또는 pandas==2.3.2)을 입력하고 설치 버튼을 누릅니다.
   • 여러 패키지를 동시에 설치하려면 콤마(,)로 구분하세요.
3. 패널의 설치된 패키지 목록에서 개별 항목 옆의 삭제 버튼으로 패키지를 제거할 수 있습니다.
4. 하단의 최근 작업 섹션과 로그 보기 링크에서 설치/삭제 결과와 pip 로그를 확인할 수 있습니다.

패키지 작업이 완료되면 LSP가 자동으로 재시작해 새 패키지를 즉시 인식합니다.

📚 컴포넌트 개발 학습 가이드

AIM-Forge 컴포넌트를 개발하고 싶다면 체계적인 학습 경로를 제공하는 가이드를 참고하세요:

👉 컴포넌트 개발자 가이드 바로가기

학습 단계:

• 🚀 Level 1: Quick Start - 첫 파이프라인 만들기
• 💡 Level 2: Custom Component 이해 - Python Script Mode & SDK Mode
• 🔧 Level 3: Production Component - 정식 컴포넌트 개발
• 🤖 Level 4: AI와 함께 개발 - Claude/GPT 활용법

📁 문서 구조

docs/
├── development/         # 시스템 개발자용
│   └── README.md        # 상세 개발 가이드
│
└── component-dev/       # 컴포넌트 개발자용
    ├── README.md        # 컴포넌트 개발 시작 가이드
    ├── CUSTOM_COMPONENT_GUIDE.md     # 커스텀 컴포넌트 규칙
    ├── COMPONENT_DEVELOPMENT.md      # 정식 컴포넌트 개발
    └── AI_COMPONENT_PROMPTS.md       # AI 도구 활용

🏗️ 프로젝트 구조

packages/
├── frontend/            # React + TypeScript + XYFlow
│   └── src/
│       ├── components/  # UI 컴포넌트
│       ├── pages/       # 라우트 페이지
│       └── stores/      # Zustand 상태 관리
│
└── backend/             # FastAPI + Python
    ├── app/
    │   ├── api/         # API 엔드포인트
    │   └── core/        # 비즈니스 로직
    └── templates/       # 컴포넌트 템플릿

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

MIT License - 자세한 내용은 LICENSE 파일을 참조하세요.

🔗 Links

• Issue Tracker
• Documentation
• API Reference