nano-code

간단한 코딩 에이전트 CLI 도구입니다.

소개

nano-code는 OpenAI API를 활용한 대화형 코딩 에이전트로, 자연어로 작업을 요청하면 자동으로 코드를 작성하고 명령을 실행합니다.

주요 기능

• 💬 대화형 채팅 인터페이스
• 🔧 자동 bash 명령 실행
• 📝 작업 기록 저장
• 🔍 명령 실행 전 확인 모드
• 📜 작업 히스토리 검색 및 탐색

설치

요구사항

• Python 3.13 이상
• OpenAI API 키

2. 의존성 설치 (uv 사용):

uv sync

3. 환경 변수 설정:

cp .env.example .env
# .env 파일을 열어서 OPENAI_API_KEY를 설정하세요

설정

.env 파일에서 다음 환경 변수를 설정할 수 있습니다:

# OpenAI API 설정
OPENAI_API_KEY=your_openai_api_key_here

# 옵션: 기본 모델 변경
# OPENAI_MODEL=gpt-4o-mini

사용법

기본 실행

nano-code

실행하면 작업을 입력할 수 있는 프롬프트가 나타납니다.

작업 지정하여 실행

nano-code --task "파이썬으로 간단한 웹 서버 만들기"
# 또는
nano-code -t "README 파일 작성하기"

출력 파일 지정

nano-code --task "작업 내용" --output ./output.json
# 또는
nano-code -t "작업 내용" -o ./output.json

대화형 모드 단축키

• 제출: Esc + Enter
• 히스토리 탐색: ↑ / ↓ (화살표 키)
• 히스토리 검색: Ctrl + R

프로젝트 구조

nano-code/
├── nano_code/
│   ├── cli.py           # CLI 진입점
│   ├── chat_agent.py    # 채팅 에이전트
│   ├── agent.py         # 기본 에이전트
│   ├── local.py         # LLM으로 로컬 환경 실행 로직
│   ├── openai_client.py # OpenAI 클라이언트
│   ├── utils/
│   │   └── save.py      # 작업 기록 저장
│   └── default.yaml     # 기본 설정
├── tests/               # 테스트
├── pyproject.toml       # 프로젝트 설정
└── README.md

개발

테스트 실행

pytest

개발 환경 설정

uv sync --dev