오늘날 사용 가능한 대부분의 셀프 호스팅 (Self-hosted) AI 애플리케이션은 무겁고 많은 자원을 요구하는 것처럼 느껴집니다. 이를 설정하려면 종종 여러 개의 Docker 컨테이너를 실행해야 하며, 1.5 GB 이상의 시스템 RAM을 소비하고, 무거운 데이터베이스 엔진과 복잡한 백엔드 프레임워크가 초기화될 때까지 최대 1분을 기다려야 합니다.

단순히 파일을 관리하고, 웹 페이지를 스크래핑하며, 문서를 생성하고, Telegram에서 대화할 수 있는 빠르고 반응성이 좋은 개인용 AI 어시스턴트를 원하는 것이 전부라면... 그렇게 많은 시스템 오버헤드 (Overhead)가 필요하지 않습니다.

이것이 제가 **Open PAIAgent**를 만든 이유입니다. 이는 로컬 머신에서 순수한 속도, 낮은 메모리 사용량, 그리고 완전한 프라이버시를 위해 특별히 설계된 오픈 소스 기반의 초경량 개인용 AI 어시스턴트입니다.

⚡ 내가 만든 것

Open PAIAgent는 TypeScript로 작성된, 불필요한 기능(Bloat)이 없는 100% 셀프 호스팅 AI 에이전트입니다. 데이터를 엄격하게 로컬에 유지하면서 일상적인 생산성을 위한 전체 도구 세트를 제공합니다:

• 💬 이중 인터페이스 (Dual Interfaces): 데스크톱을 위한 현대적인 사이버펑크 스타일의 Web UI + 이동 중 원격 접속을 위한 Telegram 봇.
• ⚡ 동적 기술 시스템 (Dynamic Skills System): LLM 컨텍스트 토큰 (Context tokens)을 절약하기 위해 쿼리 키워드(예: 이커머스 검색, 코드 리팩토링, 카피라이팅)를 기반으로 지시 프롬프트 (Instruction prompts)를 동적으로 로드합니다.
• 📁 파일 시스템 관리자 (File System Manager): 샌드박스 처리된 로컬 워크스페이스 폴더 내에서 텍스트 파일을 읽고, 생성하고, 업데이트하고, 편집합니다.
• 🌐 웹 스크래퍼 (Web Scraper): 웹 페이지를 다운로드하고 HTML 노이즈를 제거합니다. 정적 스크래핑을 지원하며, SPA (Single Page Application)를 위해 Puppeteer 헤드리스 브라우저 (Headless browser) 자동 폴백 (Fallback) 기능을 제공합니다.
• 📄 PDF 및 오피스 생성기 (PDF & Office Generator): 서식이 지정된 A4 PDF 보고서, 수식이 포함된 Excel 스프레드시트 (.xlsx), 스타일이 적용된 Word 문서 (.docx)를 생성합니다.
• 🖼️ 이미지 생성 (Image Generation): 스마트 폴백 로직과 함께 Together AI 또는 X.AI (Grok)를 사용하여 이미지를 생성합니다.
• 🧠 하이브리드 로컬 메모리 (Hybrid Local Memory): 키워드 매칭과 함께 sqlite-vec 벡터 유사도 검색 (Vector similarity search) 기능이 포함된 임베디드 SQLite를 사용합니다.
• 📋 백그라운드 작업 스케줄러 (Background Task Scheduler): 60초 폴링 (Polling) 및 실시간 Telegram 실행 알림을 통해 백그라운드 작업을 예약합니다.

⚡ 리소스 효율성이 중요한 이유

Open PAIAgent가 기존의 무거운 AI 플랫폼들과 어떻게 다른지 비교하면 다음과 같습니다:

🏗️ 아키텍처 및 주요 엔지니어링 결정 사항

왜 LangChain이나 LlamaIndex를 사용하지 않았나요?

1. 완전한 제어 (Complete Control): 에이전트의 인지 루프 (think-act-evaluate)를 순수 TypeScript (vanilla TypeScript)로 작성함으로써, 도구 호출 (tool calling) 및 컨텍스트 히스토리 (context history)에 대한 완전한 제어를 보장합니다.
2. 쉬운 디버깅 (Easy Debugging): 복잡한 다층 프레임워크 추상화 (multi-layer framework abstractions)를 디버깅하는 것에 비해, 순수 TypeScript 코드를 추적하는 것은 매우 간단합니다.
3. 1초 미만의 콜드 스타트 (Sub-Second Cold Start): Fastify + Node.js 조합은 수백 개의 무거운 의존성 (dependencies)을 로드하지 않고 즉시 부팅됩니다.

보안 샌드박싱 (Security Sandboxing)

• HTTP 기본 인증 (HTTP Basic Auth): 원격 접속을 위해 Web UI를 보호합니다.
• Telegram 사용자 화이트리스트 (Telegram User Whitelist): 봇 접근을 승인된 사용자 ID로 엄격히 제한합니다.
• 경로 샌드박싱 (Path Sandboxing): 지정된 workspace/ 폴더 외부로의 경로 탐색 (path traversal)을 방지하기 위해 엄격한 상대 경로 체크를 강제합니다.

🚀 실행 방법

2분 이내에 여러분의 기기에서 Open PAIAgent를 실행할 수 있습니다:

# 1. 저장소 클론 (Clone the repository)
git clone https://github.com/nordevelopment/OpenPersonalAIAgent
cd OpenPersonalAIAgent
...

브라우저에서 http://127.0.0.1:3000을 엽니다. 처음 실행하면 선호하는 AI 모델 제공업체 (OpenRouter, Together AI, X.AI 등)를 설정할 수 있는 대화형 설정 마법사가 나타납니다.

📺 비디오 데모 및 저장소

• 🎬 YouTube 기능 데모:
• ⭐ GitHub 저장소: nordevelopment/OpenPersonalAIAgent
• 🌐 프로젝트 웹페이지: nordevelopment.github.io/OpenPAIAgent

💡 주요 학습 내용

Open PAIAgent를 구축함으로써, 완전한 기능을 갖추고 도구를 사용하는 (tool-using) 개인용 AI 에이전트를 만들기 위해 수 기가바이트(multi-gigabyte) 규모의 컨테이너 스택이나 복잡한 추상화 (abstractions)가 필요하지 않다는 것이 증명되었습니다. Node.js, Fastify, 그리고 임베디드 SQLite 벡터 검색 (embedded SQLite vector search)을 활용함으로써, 1초 미만의 응답 속도를 구현하고 수 기가바이트의 시스템 메모리를 절약할 수 있습니다.

저장소 (repo)를 확인하거나, GitHub에 스타 (star)를 남겨주세요. 또는 댓글로 피드백을 남겨주셔도 좋습니다!

라이선스 (License): MIT — 100% 자유 및 오픈 소스 (Free and Open Source).