Metadata-Version: 2.4
Name: athena-vector-cli
Version: 0.1.1
Summary: Athena Vector Command CLI - 자연어 명령어를 벡터 시스템으로 실행
Home-page: https://github.com/mkmlab-hq/athena-vector-cli
Author: MKM Lab
Author-email: MKM Lab <contact@mkmlab.com>
License: MIT
Keywords: vector,cli,command,nlp,athena
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: qdrant-client>=1.15.1
Requires-Dist: sentence-transformers>=5.1.2
Requires-Dist: numpy>=1.24.3
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# 🏛️ Athena Vector CLI

> **Stop memorizing complex CLI flags. Let your local AI brain remember them for you.**

[![PyPI version](https://badge.fury.io/py/athena-vector-cli.svg)](https://badge.fury.io/py/athena-vector-cli)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Athena Vector CLI**는 자연어 명령어를 벡터 시스템으로 변환하여 실행하는 AI 기반 CLI 도구입니다. 복잡한 명령어를 외울 필요 없이, 자연어로 명령하면 AI가 기억하고 재사용합니다.

---

## 🎬 Demo

<!-- TODO: Add GIF here -->
![Athena Vector CLI Demo](https://via.placeholder.com/800x400?text=Athena+Vector+CLI+Demo+GIF)

**5초 데모**: `athena "undo last git commit"` → AI가 기억한 명령어를 자동으로 실행합니다.

---

## 🚀 Quick Start

### 설치

```bash
pip install athena-vector-cli
```

### 환경 변수 설정

```bash
# Qdrant 서버 URL 설정 (필수)
export VPS_QDRANT_URL="http://your-qdrant-server:6333"
# 또는
export QDRANT_URL="http://your-qdrant-server:6333"
```

### 첫 실행

```bash
# 도움말 확인
athena --help

# 자연어 명령어 실행
athena "서버 상태 보여줘"
athena "Git 저장소 상태 확인"
athena "Docker 컨테이너 목록"
```

---

## ✨ Key Features

### 🧠 **Local Vector DB**
- 데이터가 밖으로 나가지 않습니다 (Privacy First)
- 로컬 또는 자체 호스팅 Qdrant 서버 사용
- 모든 명령어는 벡터화되어 안전하게 저장됩니다

### 🔄 **Vector Command Reuse**
- 한 번 학습한 명령어는 자동으로 재사용
- 유사한 명령어를 자동으로 찾아서 실행
- 시간이 지날수록 더 똑똑해집니다

### 🛡️ **Iron Gate** (Coming Soon)
- 코드 품질 자동 검증
- 보안 취약점 자동 감지
- 배포 전 자동 테스트

### 🎯 **Natural Language Interface**
- 복잡한 CLI 플래그를 외울 필요 없음
- "undo last git commit" → `git reset HEAD~1` 자동 변환
- 한국어와 영어 모두 지원

### 📊 **Usage Tracking**
- 자주 사용하는 명령어 자동 추적
- 효율적인 명령어 우선순위 자동 조정

---

## 📖 사용 예시

### 기본 사용

```bash
# 자연어로 명령어 실행
athena "서버 상태 보여줘"

# 유사한 명령어 자동 검색 및 재사용
athena "Git 커밋 취소"
# → 이전에 학습한 "undo last git commit" 명령어 자동 실행
```

### 학습 모드

```bash
# 새로운 명령어 학습
athena "새로운 명령어"
# → 유사한 명령어가 없으면 학습 모드로 전환
# → DSL과 결과를 입력하여 저장
```

### 버전 확인

```bash
athena --version
# Athena CLI v0.1.0
```

---

## 🏗️ 아키텍처

```
┌─────────────────┐
│  자연어 명령어   │
│  "undo commit"  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  벡터 검색      │
│  (유사 명령어)   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  명령어 재사용   │
│  또는 학습       │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  실행 및 결과   │
└─────────────────┘
```

---

## 🔧 설정

### 환경 변수

| 변수 | 설명 | 필수 |
|------|------|------|
| `VPS_QDRANT_URL` | Qdrant 서버 URL | ✅ |
| `QDRANT_URL` | Qdrant 서버 URL (대체) | ✅ |
| `ATHENA_DEBUG` | 디버그 모드 (스택 트레이스 출력) | ❌ |

### Qdrant 서버 설정

**로컬 설치**:
```bash
docker run -p 6333:6333 qdrant/qdrant
```

**VPS 사용**:
```bash
export VPS_QDRANT_URL="http://your-vps-ip:6333"
```

---

## 📚 문서

- [설치 가이드](docs/INSTALL.md)
- [사용 가이드](docs/USAGE.md)
- [API 문서](docs/API.md)
- [문제 해결](docs/TROUBLESHOOTING.md)

---

## 🤝 기여하기

기여를 환영합니다! 이슈를 열거나 Pull Request를 보내주세요.

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

---

## 📝 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.

---

## 🙏 감사의 말

- [Qdrant](https://qdrant.tech/) - 벡터 데이터베이스
- [Sentence Transformers](https://www.sbert.net/) - 임베딩 모델
- [MKM Lab](https://mkmlab.com/) - 프로젝트 후원

---

## 🔗 링크

- **PyPI**: https://pypi.org/project/athena-vector-cli/
- **GitHub**: https://github.com/mkmlab-hq/athena-vector-cli
- **문서**: https://athena-vector-cli.readthedocs.io/
- **이슈**: https://github.com/mkmlab-hq/athena-vector-cli/issues

---

## ⭐ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=mkmlab-hq/athena-vector-cli&type=Date)](https://star-history.com/#mkmlab-hq/athena-vector-cli&Date)

---

**Made with ❤️ by [MKM Lab](https://mkmlab.com/)**
