Hataraku
AI 기반 도구를 구축하기 위한 자율 코딩 에이전트이자 SDK입니다. 'Hataraku'(働く)는 일본어로 '일하다'라는 의미를 가집니다.
npm version
License: MIT
설명 (Description)
Hataraku는 AI 기반 개발 도구와 자율 코딩 에이전트를 생성할 수 있게 해주는 강력한 툴킷입니다. 지능형 개발 워크플로우, 코드 분석 및 자동화 작업을 구축하기 위한 유연한 SDK와 CLI를 제공합니다.
주요 기능 (Key Features)
- 🤖 자율 코딩 에이전트 기능 (Autonomous coding agent capabilities)
- 🛠️ AI 기반 도구 구축을 위한 확장 가능한 SDK (Extensible SDK for building AI-powered tools)
- 📦 다중 AI 제공업체 지원 (OpenRouter, Claude, Amazon Bedrock)
- 🧠 RAG 애플리케이션을 위한 AWS Bedrock Knowledge Base 통합
- 🔄 워크플로우 자동화 및 병렬 작업 실행
- 📊 스키마 검증 및 구조화된 작업
- 🧰 내장 도구 통합 시스템 (Built-in tool integration system)
- 🔗 Model Context Protocol (MCP) 지원
- 🔄 Vercel의 강력한 AI SDK를 확장합니다.
설치 (Installation)
npm install -g hataraku
...
빠른 시작 (Quick Start)
SDK 사용법 (SDK Usage)
import { createAgent, createTask } from 'hataraku'
import { z } from 'zod'
...
CLI 사용법 (CLI Usage)
먼저 CLI를 전역으로 설치합니다:
새 프로젝트 초기화:
hataraku init my-project
cd my-project
CLI를 사용하여 작업 실행:
hataraku task run hello-world
...
제공업체 구성 및 사용 가능한 명령어 탐색:
hataraku provider configure openrouter
...
Glow를 이용한 출력 향상 (Enhancing Output with Glow)
Hataraku의 출력은 터미널 기반 마크다운 뷰어인 Glow를 사용하여 향상될 수 있으며, 이는 출력을 더 읽기 쉽고 시각적으로 매력 있게 만듭니다.
Glow 설치 (Installing Glow)
Hataraku와 Glow 사용하기 (Using Glow with Hataraku)
셸 설정 파일(.bashrc, .zshrc 등)에 함수를 생성합니다:
이제 hd 명령을 사용하여 향상된 출력으로 Hataraku를 실행할 수 있습니다:
더 자세한 내용은 Glow 통합 가이드를 참조하십시오.
API 개요
Hataraku는 여러 핵심 구성 요소를 제공합니다:
Task: AI 기반 작업을 생성하고 실행합니다.Agent: 자율 코딩 에이전트를 구축합니다.Workflow: 복잡한 다단계 작업을 오케스트레이션(orchestrate)합니다.Tools: 사용자 정의 기능 및 외부 서비스를 통합합니다.
자세한 API 문서는 Types Documentation를 참조하십시오.
문서
예시
이 패키지에는 /examples 디렉터리에 다양한 예제가 포함되어 있으며, 여러 기능을 시연합니다:
- 기본 작업 실행
- 스트리밍 응답
- 스키마 유효성 검사(Schema validation)
- 다단계 워크플로우
- 도구 통합
- 스레드 관리
이 예제들은 레포지토리에서 참조할 수 있으며, 다양한 사용 사례와 구현 패턴을 이해하는 데 참고할 수 있습니다.
더 자세한 내용은 examples README를 참조하십시오.
기여(Contributing)
기여를 환영합니다! 자세한 내용은 Contributing Guide를 참조하십시오.
라이선스
MIT License - 자세한 내용은 LICENSE 파일을 참조하십시오.
지원
- GitHub Issues: 버그를 보고하거나 기능을 요청하려면 여기를 클릭하세요
- 문서(Documentation): 자세한 가이드는 [docs] 디렉토리를 참조하세요.
