Autoradiographinfighting868/ai_cli

ai_cli은(는) 무엇을 하나요?

Ollama를 사용하여 오프라인 우선 AI CLI 에이전트를 실행하여, 터미널에서 시스템을 제어하고, 앱을 빌드하며, 파일을 관리하고, 프로젝트를 처리하세요.

개요

이 에이전트는 로컬 환경에서 Ollama를 통해 AI 모델을 구동하며, 모든 연산을 오프라인에서 수행합니다. 인터넷 연결이 필요하지 않으므로 데이터 프라이버시가 보장되며, 네트워크 지연 없이 빠른 응답 속도를 제공합니다.

설치 및 설정

1. Ollama 설치

   • Linux/macOS: curl -fsSL https://ollama.com/install.sh | sh
   • Windows: WSL 환경에서 설치

2. 모델 다운로드

   ollama pull llama3.2:3b  # 또는 원하는 모델
   

3. 에이전트 설정

   • config.yaml 파일에서 기본 모델, 프롬프트 템플릿, 실행 정책을 구성합니다.

사용 방법

기본적인 사용 예시:

python cli_agent.py "현재 디렉토리에서 모든 Python 파일 목록을 생성해줘"

주요 기능

• 시스템 제어: 프로세스 관리, 서비스 시작/중지, 환경 변수 설정
• 앱 빌드: 코드 생성, 빌드 스크립트 실행, 의존성 관리
• 파일 관리: 파일 읽기/쓰기/복사/이동/삭제, 검색, 패턴 매칭
• 프로젝트 관리: Git 작업, 프로젝트 초기화, 구조 생성

설정 파일 (config.yaml)

model: "llama3.2:3b"
temperature: 0.7
max_tokens: 4096
allow_critical_commands: false  # 위험한 명령어 허용 여부

안전 주의사항

• 기본적으로 중요한 시스템 명령어(rm -rf /, sudo 등)는 차단됩니다.
• 위험한 명령을 허용하려면 config.yaml에서 allow_critical_commands: true로 설정하세요.
• 에이전트가 제안하는 모든 명령은 사용자가 직접 검토한 후 실행하는 것을 권장합니다.

지원 환경

• OS: Linux, macOS, Windows (WSL)
• Python: 3.8 이상
• Ollama: 0.1.0 이상

문제 해결

• 모델이 응답하지 않음: ollama serve가 실행 중인지 확인하세요.
• 명령어 실행 오류: logs/agent.log 파일을 확인하세요.
• 권한 문제: 에이전트 실행 사용자에게 적절한 권한이 있는지 확인하세요.

라이선스

MIT License