athena-vector-cli 0.1.1

Athena Vector Command CLI - 자연어 명령어를 벡터 시스템으로 실행

🏛️ Athena Vector CLI

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

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

---

🎬 Demo

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

---

🚀 Quick Start

설치

pip install athena-vector-cli

환경 변수 설정

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

첫 실행

# 도움말 확인
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

• 자주 사용하는 명령어 자동 추적
• 효율적인 명령어 우선순위 자동 조정

---

📖 사용 예시

기본 사용

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

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

학습 모드

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

버전 확인

athena --version
# Athena CLI v0.1.0

---

🏗️ 아키텍처

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

---

🔧 설정

환경 변수

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

Qdrant 서버 설정

로컬 설치:

docker run -p 6333:6333 qdrant/qdrant

VPS 사용:

export VPS_QDRANT_URL="http://your-vps-ip:6333"

---

📚 문서

• 설치 가이드
• 사용 가이드
• API 문서
• 문제 해결

---

🤝 기여하기

기여를 환영합니다! 이슈를 열거나 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 파일을 참조하세요.

---

🙏 감사의 말

• Qdrant - 벡터 데이터베이스
• Sentence Transformers - 임베딩 모델
• MKM Lab - 프로젝트 후원

---

🔗 링크

• 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

---

Made with ❤️ by MKM Lab