오픈소스 리뷰 · 2026

Paperclip AI 완전 분석:
"에이전트가 직원이라면,
이게 바로 회사다"

에이전트를 조직으로 엮는 오픈소스 오케스트레이션 플랫폼. 출시 수 주 만에 GitHub 스타 32K 돌파, 마켓플레이스 출시 예정, "인간 없는 회사"라는 개념을 현실로 만드는 프레임워크를 구석구석 해부한다. 설치부터 실전 운영까지 포함.

작성 2026년 3월 25일 저자 22B Labs · The 4th Path 읽기 약 12분 레포 paperclipai/paperclip

종합 점수

8.7

★★★★☆

추천 대상: 솔로 파운더, 멀티에이전트 빌더, AI 스타트업

"에이전트 20개를 동시에 관리하려면 어떻게 해야 하나"에 대한 가장 완성도 높은 오픈소스 답변. 초기 거친 부분이 있지만 아키텍처는 탄탄하고 모멘텀은 확실하다.

목차 Paperclip이란 핵심 기능 사용 방법 시장 반응 활용 사례 경쟁 비교 로드맵 리스크와 한계 최종 평가

Paperclip이란 무엇인가

Paperclip은 여러 AI 에이전트를 하나의 조직으로 묶어주는 오픈소스 Node.js 서버 + React 대시보드다. 공식 README의 한 줄 정의가 가장 정확하다: "하트비트를 받을 수 있다면, 고용된 것이다."

만든 계기가 흥미롭다. 개발자 @dotta는 자동화 헤지펀드를 운영하면서 Claude Code 탭을 20개씩 열어두는 상황에 직면했다. 공유 컨텍스트 없음, 비용 추적 없음, 재부팅 후 상태 복구 불가. Paperclip은 그 혼돈을 해결하기 위해 만들어졌다.

Paperclip은 OpenClaw나 Claude Code와 경쟁하지 않는다. 그 에이전트들을 고용한다. OpenClaw가 직원이라면, Paperclip은 급여를 주고, 목표를 세우고, 감사 내역을 보관하는 회사다.

— The 4th Path, 2026

핵심 구분을 이해하는 게 중요하다. Paperclip은 컨트롤 플레인이지 실행 엔진이 아니다. 오케스트레이션이 역할이고, 실행은 에이전트가 한다. Claude Code, Codex, OpenClaw, Cursor, Python 스크립트, HTTP 웹훅 — 무엇이든 가져오면 Paperclip이 조직을 부여한다.

핵심 기능 8가지

🏢

AI 조직도

CEO, CTO, CMO, 엔지니어, 디자이너를 에이전트 역할로 정의. 위임은 계층 구조를 따라 흐른다. 각 에이전트는 자신의 범위와 보고 라인을 안다.

💸

예산 자동 집행

에이전트별 월간 토큰 한도 설정. 80%에서 소프트 경고, 100%에서 자동 일시정지. 작업·프로젝트·목표 단위로 비용 추적. 예상치 못한 API 청구서 없음.

🔒

거버넌스 & 롤백

민감한 단계마다 승인 게이트 강제. 설정 변경은 버전 관리. 잘못된 변경은 롤백 가능. 에이전트는 이사회 승인 없이 다른 에이전트를 고용할 수 없다.

🎯

목표 연계 실행

태스크는 조직도를 따라 전체 목표 계보를 전달. 에이전트는 티켓 제목만이 아닌 "왜 이 일을 하는지"를 항상 인지한다.

🔄

에이전트 상태 유지

에이전트는 하트비트 간격을 넘어도 동일한 작업 컨텍스트를 이어받는다. 매번 재시작하지 않고 중단된 곳부터 계속 진행.

📋

불변 감사 로그

모든 툴 호출, API 요청, 의사결정 시점이 로깅됨. 추가 전용(append-only). 편집도 삭제도 없음. 모든 자율 행동에 대한 완전한 책임 추적.

🏗️

멀티 컴퍼니 격리

하나의 배포에서 수십 개의 완전 격리된 회사 운영 가능. 회사별 목표, 에이전트, 예산, 감사 로그 분리. 포트폴리오 전체를 단일 컨트롤 플레인으로.

🔌

런타임 스킬 주입

에이전트가 재훈련 없이 런타임에 Paperclip 워크플로우와 프로젝트 컨텍스트를 학습. 핵심 코드를 건드리지 않고 드롭인 확장으로 기능 추가.

사용 방법: 설치부터 첫 에이전트 운영까지

Paperclip의 설계 목표는 "설치 후 5분 안에 CEO 에이전트가 첫 태스크를 완료"하는 것이다. Node.js만 있으면 외부 서비스 없이 실행 가능하다.

1

사전 준비

Node.js 18 이상이 설치되어 있어야 한다. Claude Code, Codex, OpenClaw 등 연결할 에이전트의 API 키도 준비해두자. 별도 PostgreSQL 설치는 불필요 — Paperclip이 임베디드 DB를 자동 생성한다.

# Node.js 버전 확인 node -v # v18 이상이어야 함

2

한 줄 설치 & 초기 설정

npx paperclipai 명령 하나로 전부 해결된다. 처음 실행 시 대화형 온보딩 마법사가 DB 설정, 인증, 첫 번째 회사 생성을 안내한다.

# 권장: 자동 온보딩 포함 원스텝 실행 npx paperclipai # 또는 단계별 분리 실행 npx paperclipai onboard # 초기 설정 (최초 1회) npx paperclipai run # 서버 시작

💡 서버가 시작되면 http://localhost:3100 에서 대시보드에 접근할 수 있다. 처음 실행 시 생성된 초대 URL을 브라우저에서 열어 관리자 계정을 등록한다.

3

회사(Company) 생성 & 미션 설정

대시보드 접속 후 첫 회사를 만든다. 회사명과 미션을 입력하면 이후 모든 에이전트 활동이 이 미션에 연계된다. 여러 프로젝트(그룹)를 회사 아래에 배치할 수 있다.

# 예시: 블로그 자동화 회사 설정 Company Name: The 4th Path Media Mission: AI를 활용해 고품질 기술 블로그를 자동으로 생산하고 수익화한다 Projects: Blog Content / SEO Research / Social Distribution

💡 미션 문장이 구체적일수록 에이전트가 태스크의 "왜"를 더 잘 이해한다. 이것이 Paperclip의 Goal-Aware Execution 핵심이다.

4

에이전트(Agent) 등록 & 어댑터 연결

에이전트 메뉴에서 역할(CEO, CTO, 마케터 등)을 정의하고 어댑터 타입을 선택한다. 지원 어댑터: Claude Code, OpenClaw, Codex, Cursor, OpenCode, Gemini CLI, Pi, 커스텀 HTTP 웹훅.

# 에이전트 예시 구성 Role: CEO (전략 분해 & 태스크 배분) Adapter: Claude Code API Key: sk-ant-... Budget: $30/월 Role: Engineer (코드 작성 & 버그 수정) Adapter: Codex API Key: sk-... Budget: $50/월 Role: Marketer (콘텐츠 작성 & SEO) Adapter: OpenClaw Budget: $20/월

💡 에이전트 설정 후 Test now 버튼으로 어댑터 환경 검사를 실행한다. "hello probe succeeded" 메시지가 나오면 정상 연결.

5

예산 설정 & 승인 게이트 구성

에이전트별 월간 예산을 설정한다. 80% 도달 시 소프트 경고 알림, 100% 도달 시 자동 일시정지. 새 에이전트 고용이나 전략 실행 같은 민감한 작업은 이사회(나) 승인이 필요하도록 게이트를 설정한다.

# 예산 관련 자동 동작 80% 도달 → Soft warning 알림 100% 도달 → 에이전트 자동 일시정지 (새 태스크 차단) 이사회 수동 개입 → 한도 초과 허용 & 재개 가능 # 게이트 설정 예시 "새 에이전트 고용" → 이사회 승인 필요 "$100 이상 외부 서비스" → 이사회 승인 필요 "프로덕션 배포" → 이사회 승인 필요

6

목표(Goal) & 이슈(Task) 등록

회사 목표를 계층적으로 분해한다: 회사 미션 → 프로젝트 → 목표 → 이슈(태스크). 이슈를 생성하면 Paperclip이 적합한 에이전트에게 자동 배정하거나, 수동으로 담당자를 지정할 수 있다.

# 이슈 생성 예시 Title: "3월 AI 트렌드 블로그 포스트 작성" Goal: Q1 콘텐츠 목표 Assigned To: Marketer Agent Priority: High Context: The 4th Path 브랜드 톤, 기술 독자 대상, 1500자 이상

💡 이슈에 컨텍스트를 상세히 적을수록 에이전트가 더 좋은 결과를 낸다. 이슈 스레드에서 @에이전트명으로 멘션하면 즉시 깨어나 작업을 시작한다.

7

하트비트 스케줄 설정 & 자율 운영

에이전트는 기본적으로 스케줄 기반 하트비트와 이벤트 트리거(태스크 배정, @멘션)로 작동한다. OpenClaw처럼 연속 실행하는 에이전트도 연결 가능. 이 단계부터 에이전트들이 자율적으로 작업을 수행한다.

# 하트비트 실행 흐름 (자동) 에이전트 깨어남 (스케줄 or 이벤트) → 작업 큐 확인 → 배정된 이슈 체크아웃 (atomic, 중복 방지) → 도구 실행 (웹 검색, 코드 작성, DB 조회 등) → 결과 반환 & 이슈 업데이트 → 비용 기록 → 다음 하트비트까지 대기

8

대시보드에서 모니터링 & 이사회 역할 수행

당신의 역할은 이사회다. 대시보드는 항상 다섯 가지 질문에 답한다: 회사가 무엇을 하고 있나? 누가 하고 있나? 왜 중요한가? 비용은 얼마인가? 내 승인이 필요한 것은 무엇인가? 이상 감지 시 에이전트를 즉시 일시정지·재배정·종료할 수 있다.

# 이사회로서 할 수 있는 것 에이전트 일시정지 / 재개 / 종료 전략 검토 & 승인 / 거부 예산 한도 조정 (긴급 초과 허용) 태스크 재배정 설정 변경 롤백 (버전 기반)

💡원격에서도 관리하려면 Tailscale로 로컬 인스턴스에 접근하거나, Vercel / Zeabur에 배포해 24/7 운영할 수 있다.

"모든 것을 직접 설치한다고 해서 복잡하지 않다. 첫 번째 CEO 에이전트가 태스크를 완료하는 것을 보는 순간, 이게 다른 무엇과도 다른 카테고리라는 것을 느끼게 된다."

— paperclipai.info, 7일 튜토리얼, 2026

시장 반응: 예상보다 빠른 확산

숫자가 이야기를 대신한다. Paperclip은 2026년 3월 초에 출시되어 수 주 만에 GitHub 스타 32,000개를 돌파했다. Trendshift, Microlaunch, daily.dev에서 동시에 트렌딩하는 것은 단순 홍보가 아닌 실제 개발자 관심의 신호다.

GitHub 현황 · 2026년 3월 25일 기준

32.2K

GitHub 스타

출시 3주 만에 달성

4.5K

포크

높은 포크 비율 = 실제 빌더 채택 신호

1,473

커밋

2026년 3월 24일에도 업데이트

414

이슈

활발한 커뮤니티 피드백

528

PR

강력한 외부 기여자 모멘텀

MIT

라이선스

완전 오픈, 계정 불필요, 셀프호스팅

출처: github.com/paperclipai/paperclip

Zeabur는 출시 며칠 만에 원클릭 Paperclip 템플릿을 배포했다. Dealroom, UCStrategies, TopAIProduct, Flowtivity 등 주요 미디어에서 분석 기사가 쏟아졌다. 특히 대부분의 커버리지가 홍보성이 아닌 실무자 관점의 분석이었다는 점이 주목할 만하다.

"레포는 잘 구조화되어 있고, 활발히 유지되고 있으며, 사람들에게 명확히 공명하고 있다. 실제 가드레일을 갖추고 AI 에이전트 집단을 한 지붕 아래 조율할 방법을 찾고 있었다면, Paperclip은 진지하게 살펴볼 가치가 있다."

— TopAIProduct.com, 2026년 3월

가장 강력한 신호는 실제 운영 사례의 선행 존재다. Business Insider는 2026년 2월에 솔로 파운더 Aaron Sneed가 GPT 에이전트 15개를 경영진 협의체로 운영하며 주당 20시간 이상을 절약하고 있다고 보도했다. AI 실무자 Nat Eliason의 에이전트 "Felix"는 10만 달러 이상의 매출을 기록했다고 알려졌다. Paperclip은 "인간 없는 회사"라는 개념을 발명한 것이 아니라, 그 개념에 인프라를 부여했다.

실전 활용 사례

솔로 파운더

AI 스태프 마이크로 SaaS

인간 한 명이 전략을 설정. Paperclip이 CEO(기획), CTO(코딩), 마케터(콘텐츠) 에이전트를 예산 한도와 승인 게이트 아래에서 운영.

개발

병렬 코딩 에이전트 관리

연결이 끊긴 Claude Code 탭 20개를 단일 Paperclip 조직으로 대체. 각 에이전트는 태스크, 예산, 재부팅 후에도 유지되는 상태를 보유.

콘텐츠

자동화 콘텐츠 파이프라인

리서치 에이전트 → 작성 에이전트 → 편집 에이전트 → 발행 에이전트. Paperclip이 핸드오프를 조율하고 비용을 추적하며 인간 검토가 필요한 것을 플래그.

포트폴리오

멀티 벤처 대시보드

하나의 Paperclip 인스턴스에서 여러 격리된 회사를 운영. 각 벤처는 자체 조직도, 에이전트, 예산을 보유. 운영자 한 명, 자율 비즈니스 다수.

금융 / 컴플라이언스

관리된 에이전트 워크플로우

승인 게이트와 불변 감사 로그로 민감한 운영에도 활용 가능. 모든 행동이 기록되고 추적됨 — 대부분의 오픈소스 도구보다 엔터프라이즈 컴플라이언스에 가깝다.

22B Labs 적용

블로그 수익 자동화 엔진

리서치, 글쓰기, SEO 검토, 발행 에이전트를 하나의 Paperclip 회사 아래 오케스트레이션. 에이전트별 예산과 롤백 기능으로 안전하게 The 4th Path 운영.

경쟁 도구 비교

2026년 에이전트 오케스트레이션 공간은 혼잡하다. 하지만 Paperclip의 실제 레이어 — 조직 컨트롤 플레인, 에이전트 런타임이 아님 — 를 이해하면 비교 대상이 크게 줄어든다. 대부분의 경쟁 도구는 완전히 다른 추상화 레이어에서 작동한다.

도구	레이어	조직 구조	예산 제어	모델 독립	라이선스
Paperclip	컨트롤 플레인	✅ 완전한 조직도	✅ 에이전트별 한도	✅ 하트비트 가능 모두	MIT
LangGraph	워크플로우 그래프	❌ 없음	❌ 수동	✅ 예	MIT
CrewAI	역할 기반 에이전트	⚠ 역할만	❌ 없음	✅ 예	MIT
AutoGen	에이전트 대화	❌ 없음	❌ 없음	✅ 예	MIT
OpenClaw	자율 에이전트 런타임	❌ 단일 에이전트	❌ 없음	✅ 예	오픈
MS Copilot Studio	엔터프라이즈 플랫폼	⚠ 워크플로우 수준	✅ Azure 청구	❌ MS 스택	상용
Salesforce Agentforce	CRM 내장 에이전트	⚠ CRM 범위	✅ 플랫폼 제어	❌ Salesforce만	상용
DeerFlow	Docker 에이전트	❌ 없음	❌ 없음	✅ 예	오픈

LangGraph, CrewAI, AutoGen은 에이전트 조합 프레임워크다 — 파이프라인을 만드는 것을 돕는다. Paperclip은 조직 운영 체제다 — 그 파이프라인이 실행되는 동안 관리한다. 이것은 경쟁이 아니라 상호 보완이다. CrewAI 크루를 Paperclip의 에이전트 중 하나로 실행할 수 있다.

로드맵 & 발전 가능성

✅ 출시 완료

핵심 플랫폼 — 조직도, 예산, 거버넌스, 감사 로그, 멀티 컴퍼니 격리, 임베디드 Postgres, Docker 지원

✅ 출시 완료

에이전트 어댑터 — Claude Code, OpenClaw, Codex, Cursor, OpenCode, Pi, Gemini CLI 퍼스트클래스 지원

🔄 진행 중

Clipmart — AI 회사 템플릿 마켓플레이스. "콘텐츠 에이전시"나 "개발 샵" 조직을 원클릭으로 다운로드해 즉시 실행

🔄 진행 중

외부 티켓 시스템 통합 — Jira, Linear, GitHub Issues와 연동. 기존 워크플로우를 그대로 쓰면서 Paperclip을 오케스트레이션 레이어로 추가

📍 예정

클라우드 에이전트 — 호스팅 에이전트 실행 레이어. 각 에이전트의 런타임 인프라를 직접 관리할 필요 없어짐

📍 예정

온보딩 개선 — 설치 후 5분 안에 첫 CEO 태스크 완료. 현재의 인증·API 키 설정 마찰 포인트 해소

📍 예정

플러그인 시스템 — 핵심 코드 수정 없이 드롭인 확장으로 기능 추가. 커뮤니티 기여 통합 생태계

Clipmart의 잠재력이 가장 흥미롭다. 역할·스킬·워크플로우가 미리 설정된 회사 템플릿 마켓플레이스는 Paperclip을 개발자 도구에서 플랫폼으로 전환시킨다. "AI 회사를 위한 npm"이 될 수 있다.

— The 4th Path 분석, 2026

⚠ 리스크, 한계, 솔직한 비판

• 온보딩 마찰이 실재한다: PRODUCT.md가 "활발한 온보딩/인증 이슈"를 명시적으로 언급한다. 5분 내 첫 태스크 완료는 목표이지, 현재 일관된 현실이 아니다. 비개발자에게는 API 키 설정이 진입 장벽이 될 수 있다.
• 오류 연쇄 위험: 에이전트들이 서로의 출력을 입력으로 쓸 때 실수가 빠르게 증폭된다. Flowtivity는 배치 아웃리치가 3명 대신 23명에게 전달된 실제 사고를 문서화했다. 인간 체크포인트 없이는 오류가 성공과 같은 속도로 확산된다.
• 단일 에이전트에는 불필요: Paperclip의 README 자체가 말한다: "에이전트가 하나라면 Paperclip이 필요 없다. 스무 개라면 반드시 필요하다." 소규모에서 조직 구조의 오버헤드는 오히려 부담이다.
• 외부 티켓 시스템 미지원 (현재): Jira, Linear와 직접 연동은 로드맵에 있지만 아직 미출시. 기존 워크플로우에 이미 깊이 박혀있는 팀은 마이그레이션 비용을 고려해야 한다.
• 엔터프라이즈 RBAC은 V1 범위 밖: 세밀한 인간 역할 권한은 명시적으로 연기됨. 다중 사용자 거버넌스는 회사 범위로만 제한. 전통적 IT 보안 기준의 엔터프라이즈 환경에는 아직 부족하다.
• 커뮤니티 기여 품질 편차: 빠르게 성장하는 오픈소스 프로젝트의 특성상 Gemini CLI, Cursor 등 커뮤니티 기여 어댑터의 품질이 균일하지 않다. 프로덕션 적용 전 반드시 테스트가 필요하다.

✓ 그럼에도 Paperclip에 베팅할 이유

• 추상화가 옳다 — "실행 플레인 위의 컨트롤 플레인"은 멀티에이전트 시스템 규모화를 위한 정확한 아키텍처
• MIT 라이선스, 셀프호스팅, 벤더 종속 없음 — AI 인력에 대한 감사 로그를 포함해 모든 것을 소유
• 어댑터 독립 설계는 미래에도 잘 작동함 — 새로운 에이전트 런타임이 등장해도 재설계 없이 플러그인 가능
• Clipmart는 진정한 플랫폼 잠재력을 가짐 — 템플릿 마켓플레이스는 "AI 회사용 npm"이 될 수 있음
• 수 주 만에 1,473 커밋과 528 PR은 창작자 모멘텀이 아니라 커뮤니티 신호 — 이미 탈출 속도 확보
• "인간 없는 회사" 테제가 현재 실제 운영자들에 의해 검증되고 있음 — 미래 예측이 아닌 현재 진행형

최종 평가: 에이전트 시대가 필요로 하던 인프라 레이어

Paperclip은 2026년의 가장 화려한 AI 프로젝트가 아니다. 이미지를 생성하지 않고, 시를 쓰지 않고, 2분짜리 데모가 인상적이지도 않다. 대신 진지한 AI 빌더라면 누구나 결국 부딪히는 진짜 어려운 문제를 해결한다: 에이전트 팀을 어떻게 관리하는가?

그 답은 아키텍처적으로 탄탄하고, 실용적으로 유용하며, 전략적으로 잘 포지셔닝되어 있다. 22B Labs처럼 여러 에이전트를 동시에 운영하면서 The 4th Path를 만들어가는 솔로 파운더에게, 이것은 배포할 가치가 있는 인프라다.

⭐ 8.7 / 10  ·  추천 대상: 솔로 파운더, 멀티에이전트 빌더, AI 퍼스트 스타트업

GitHub 레포 보기 paperclip.ing

참고 출처

1. paperclipai/paperclip — README.md, PRODUCT.md, Releases · github.com/paperclipai/paperclip
2. paperclip.ing — 공식 제품 사이트 · paperclip.ing
3. DeepWiki — Prerequisites and Installation Guide (Mar 2026) · deepwiki.com
4. paperclipai.info — 7일 Paperclip AI 튜토리얼 (2026) · paperclipai.info
5. Flowtivity — Zero-Human Companies Are Here (Mar 2026) · flowtivity.ai
6. Flowtivity — OpenClaw vs Paperclip 비교 (Mar 2026) · flowtivity.ai
7. Dealroom.co — Paperclip: the open-source framework turning AI agents into companies (Mar 2026) · dealroom.co
8. TopAIProduct — Paperclip AI Wants to Run Your Entire Company (Mar 2026) · topaiproduct.com
9. Zeabur — Deploy Paperclip AI Agent Orchestration (2026) · zeabur.com
10. Apidog — Paperclip: How to Run a One-Person Company (2026) · apidog.com
11. eWeek — Meet Paperclip: The Tool Turning OpenClaw Agents Into an AI Company (2026) · eweek.com

이어서 읽기 — The 4th Path

AI 트렌드

멀티 에이전트 시대: AI끼리 대화하면 무슨 일이 일어나나

Paperclip 같은 도구가 왜 존재하는지 — 멀티에이전트 운동이 2026년에 향하는 방향까지.

더 읽기 →

빌드 로그

AI 릴레이 봇 구축기: Claude + Codex를 루프로 연결하다

Paperclip을 주목하게 된 직접적인 계기 — 두 AI가 인간 개입 없이 협력하도록 만든 경험.

더 읽기 →

전략

1인 기업을 AI 팀으로 운영하기

OpenClaw 등 에이전트를 분산 인력으로 운영하는 방법 — Paperclip이 이 구조의 조직화 레이어로 완벽하게 들어맞는다.

더 읽기 →

프로젝트

AI 자동화로 블로그 수익 엔진 만들기

22B Labs가 구축 중인 콘텐츠 파이프라인 — Paperclip이 전체 시스템의 조율 레이어로 어떻게 연결되는지.

더 읽기 →

※ 발행 전 href 값을 실제 포스트 URL로 교체하세요.

PaperclipAI 오픈소스 에이전트오케스트레이션 무인회사 멀티에이전트 AI자동화 솔로파운더 기술리뷰 The4thPath 22BLabs

4P

22B Labs · The 4th Path

AI 연구·자동화 실험실 / the4thpath.com / github.com/sinmb79

🏗 토지·건축 행정 MIT 오픈소스 AI 무료 사용 가능

건축사 없이
개발행위허가 서류를
직접 준비한다 — PERMITA

토지 정보만 입력하면 법령 자동 검토부터 신청서·도면·체크리스트까지
4단계로 완성하는 AI 보조 웹 앱

📅 2026. 03. 25. ✍ 22B Labs 🏷 React · Vite · 순수 클라이언트사이드 · MIT

땅을 개발하려면 개발행위허가가 필요합니다. 문제는 어떤 서류가 필요한지, 어떤 법령을 따라야 하는지 일반인 혼자 파악하기가 너무 어렵다는 것입니다. 국토계획법, 농지법, 산지관리법, 지자체 조례까지 검토해야 할 항목이 한두 가지가 아닙니다.

결국 비용을 들여 건축사나 행정사를 찾게 되는데, 소규모 개발이나 농막·태양광 같은 단순한 경우에는 과도한 비용이 들기도 합니다. PERMITA는 이 과정을 일반인도 직접 처리할 수 있도록 AI가 4단계로 안내해주는 웹 앱입니다. 오늘 MIT 라이선스로 전체 소스코드를 공개합니다.

이런 상황을 겪어본 적 있다면 PERMITA가 도움이 됩니다:

✔ 농막을 설치하려는데 어떤 서류를 내야 하는지 모른다
✔ 논에 태양광을 설치하려는데 농지법에 걸리는지 확인이 필요하다
✔ 자재 야적장을 만들려는데 개발행위허가 대상인지 모른다
✔ 건축사에게 맡기기엔 규모가 작아 직접 해보고 싶다
✔ 어느 담당 부서에 가서 무엇을 물어봐야 할지조차 모른다

4단계 진행 흐름

1

개발 의도 파악

자유 입력 또는 AI 대화로 개발 내용 정리

2

토지 정보 입력

지목·용도지역·농업진흥구역 등 입력

3

법령 자동 검토

국토계획법·농지법 등 적합 여부 자동 판정

4

서류 자동 생성

신청서·사업계획서·도면·체크리스트 완성

지원하는 개발행위 유형

🚜

토지 형질변경

절토·성토·평탄작업

📦

물건 적치

자재·컨테이너 야적

🏡

농막 설치

농지 내 20㎡ 이하 휴게시설

☀️

소규모 태양광

부지 내 태양광 발전시설

🏗

가설건축물

임시 구조물

⛏

토석채취

흙·돌 채취

⚠️ 건축사 날인이 필요한 건축허가는 이 서비스 범위 밖입니다. PERMITA는 건축허가가 아닌 개발행위허가 전용 도우미입니다.

법령 자동 검토 — 3층 구조

입력한 토지 정보를 바탕으로 아래 3단계 법령 체계를 자동으로 검토합니다. 각 항목마다 적합 / 부적합 / 확인 필요 / 해당없음 4가지로 판정 결과를 표시합니다.

층위	검토 내용
법령	국토계획법, 농지법, 산지관리법, 환경영향평가법
업무지침	국토교통부 개발행위업무지침 (경사도·우수처리·경관 등)
조례	지자체 조례 항목 (이격거리·추가 기준 등)

자동 생성 서류 4종

서류	설명
개발행위허가 신청서	별지 제1호 서식 자동 작성
사업계획서	AI 초안 자동 생성 또는 빈 양식
제출서류 목록	법적 근거 및 발급처 포함
심사 체크리스트	업무지침 별첨 서식 — 담당자 제출용

도면은 배치도·형질변경계획도·횡단면도·태양광 배치도·농막 배치도를 SVG로 파라메트릭 자동 생성합니다. 수치를 직접 편집하고 PDF로 바로 인쇄할 수 있습니다.

AI 설정 — 무료로도 전부 사용 가능

기본값은 템플릿 모드(무료)입니다. AI 없이도 법령 검토, 서류 생성, 도면 출력 모두 사용할 수 있습니다. AI를 연결하면 대화형 의도 파악과 사업계획서 자동 작성이 추가됩니다.

Claude

API 키 필요

GPT-4o

API 키 필요

Gemini

API 키 필요

Ollama

로컬 무료

템플릿

완전 무료

🔒 보안: API 키는 브라우저의 sessionStorage에만 임시 저장됩니다. 탭을 닫으면 자동 삭제되며, 외부 서버로 전송되지 않습니다.

서버 없이 실행 — 5분 세팅

PERMITA는 완전 클라이언트사이드 앱입니다. 서버·DB·백엔드가 전혀 필요 없습니다.

git clone https://github.com/sinmb79/PERMITA------.git
cd PERMITA------
npm install
npm run dev

브라우저에서 http://localhost:5173으로 접속하면 바로 사용할 수 있습니다. 빌드 후 dist/ 폴더를 Vercel, GitHub Pages, Cloudflare Pages 등 어디든 정적 호스팅에 그대로 배포할 수 있습니다.

기술 스택

React 18 Vite useReducer SVG 파라메트릭 도면 순수 클라이언트사이드 외부 라이브러리 최소화

MIT 라이선스 무료 공개

PERMITA는 MIT 라이선스로 전체 소스코드를 공개합니다. 지자체, 부동산 플랫폼, 농업 관련 서비스 등 누구든 자유롭게 활용·수정·배포할 수 있습니다.

이 앱은 참고용 도우미입니다. 실제 허가 신청 전 반드시 해당 시·군·구 담당 부서에서 최종 확인하세요. 법령은 개정될 수 있으므로 최신 법령 적용 여부도 확인이 필요합니다.

📦 GitHub에서 받아보기

전체 소스코드 · 스크린샷 · 설치 가이드 포함

sinmb79/PERMITA 바로가기 →

#PERMITA #개발행위허가 #토지개발 #농막허가 #태양광허가 #부동산행정AI #오픈소스 #React #Vite #22BLabs #The4thPath

🔓 무료 오픈소스 공개

공문닥터 v1.0 —
공공·민간 기관을 위한
한글 문서 자동 교정 도구

보안이 엄격한 환경에서도 안심하고 쓰는 HWP/HWPX 맞춤법·공문서체 교정기

📅 2026. 03. 25. ✍ 22B Labs 🏷 오픈소스 · Python · 공공문서

공공기관이나 기업에서 공문서를 작성할 때마다 이런 고민을 해본 적이 있을 것입니다. "맞춤법은 맞는데, 공문서 형식에 맞는 표현인지 모르겠다." 혹은 "보안 정책상 외부 서버에 문서를 올릴 수 없어서 온라인 교정기를 쓸 수가 없다."

이 문제를 해결하기 위해 개발한 도구가 바로 공문닥터(GongmunDoctor)입니다. 오늘 v1.0을 MIT 라이선스로 GitHub에 무료 공개합니다.

문서 내용이 외부 서버로 단 한 바이트도 전송되지 않습니다. 규칙 기반 교정(L1-L3)은 완전 오프라인으로 동작합니다.

공문닥터란?

공문닥터는 한글(HWP/HWPX) 문서의 맞춤법, 문법, 공문서체 오류를 자동으로 교정하는 Python 기반 CLI/GUI 도구입니다. 「한글 맞춤법」, 「행정업무운영편람」, 국립국어원 공문서 바로 쓰기 지침을 기반으로 한 69개 교정 규칙을 내장하고 있으며, 모든 교정 항목에 법적·규범적 근거를 함께 명시합니다.

🔒

완전 오프라인 동작

규칙 교정은 인터넷 없이 PC 내부에서만 처리됩니다.

📋

공문서체 전문 교정

일반 맞춤법 + 행정 문서 특화 규칙 69개 내장

🤖

AI 심층 분석 (선택)

로컬 GGUF 또는 Claude/GPT/Gemini API 연동

🛡️

PII 자동 마스킹

AI 사용 시 주민번호·계좌번호·이메일 등 자동 익명 처리

💻

CLI / GUI / 플러그인

명령줄, 그래픽 화면, 한글 시스템 트레이 세 가지 지원

📄

교정 보고서 생성

교정 근거와 원문/수정본을 담은 Markdown 보고서 자동 생성

교정 규칙 3계층 구조

계층	분류	규칙 수	예시
L1	맞춤법·띄어쓰기	32개	됬습니다 → 됐습니다
L2	문법	12개	처리되어지고 있습니다 → 처리되고 있습니다
L3	공문서체	25개	협조 부탁드립니다 → 협조 바랍니다
L4	AI 심층 분석 (선택)	—	중복 표현·복잡한 문장·피동 남용 탐지

3분 안에 시작하기

Python 3.10 이상이 설치되어 있다면 바로 사용할 수 있습니다.

pip install -e .
gongmun-doctor correct 문서.hwpx --report

GUI가 편하다면:

gongmun-doctor-gui

한글에서 단축키로 바로 교정하려면:

pip install -e ".[hwp]"
gongmun-doctor plugin

기본 단축키 Ctrl+Shift+G를 누르면 현재 열려 있는 한글 문서가 즉시 교정됩니다. 변경 추적 모드로 동작하므로 수락/거절 여부를 직접 결정할 수 있습니다.

보안 설계: 왜 신뢰할 수 있나?

공공기관 업무 환경의 가장 큰 제약은 문서 보안입니다. 공문닥터는 처음 설계 단계부터 이 문제를 핵심으로 다루었습니다.

규칙 기반 교정(L1-L3)은 네트워크 연결 자체가 필요 없습니다. 클라우드 AI(L4)를 선택적으로 연동하더라도, 문서가 전송되기 직전에 주민등록번호·전화번호·이메일·계좌번호·주소 등 6종의 개인정보를 자동으로 익명 토큰으로 치환합니다. API 키도 환경변수로만 처리하여 소스코드나 로그에 기록되지 않으며, 교정 전 원본 파일은 항상 자동 백업됩니다.

MIT 라이선스 무료 공개

공문닥터는 MIT 라이선스로 GitHub에 전체 소스코드를 공개합니다. 개인, 기업, 공공기관 모두 제약 없이 사용·수정·배포할 수 있습니다. 교정 규칙도 JSON 파일로 관리되어 기관 내부 규정에 맞게 손쉽게 추가하거나 수정할 수 있습니다.

보안 규정 때문에 외부 서비스를 쓰지 못했던 공공기관 담당자분들께 실질적인 도움이 되기를 바랍니다.

📦 지금 바로 받아보세요

전체 소스코드, 설치 가이드, 교정 규칙 문서를 GitHub에서 확인하세요.

GitHub에서 공문닥터 받기 →

#공문닥터 #한글문서교정 #HWP교정 #공문서자동화 #오픈소스 #Python #공공기관 #맞춤법검사 #22BLabs #MIT라이선스

🏗 건설 AI MIT 무료공개

소형 건설업체의
잡무 70%를 없앤다
— CONAI 공개

현장소장이 직접 해야 할 판단은 그대로 두고,
매일 반복되는 행정·문서·안전 관리를 AI 4인이 대신합니다

📅 2026. 03. 25. ✍ 22B Labs / The 4th Path 🏷 Python · Next.js · Claude API · 오픈소스

대형 건설사는 공무팀, 품질팀, 안전팀이 따로 있습니다. 반면 소형 건설업체의 현장소장은 이 모든 업무를 혼자 또는 1~2명이서 감당합니다. 작업일보, 검측요청서, 주간보고서, 인허가 추적, 안전 TBM 자료… 매일 쌓이는 행정 잡무가 실제 현장 관리에 쓸 시간을 잡아먹습니다.

이 문제를 해결하기 위해 CONAI(건설 AI 통합관리 플랫폼)를 개발했습니다. 오늘 MIT 라이선스로 전체 소스코드를 GitHub에 공개합니다.

"대형사가 12~22명으로 하는 일을
소형업체 1~2명이 AI와 함께 해낼 수 있도록"

CONAI가 해결하는 문제

✔ 작업일보를 매일 손으로 작성하고 있다
✔ 검측요청서를 매번 처음부터 만든다
✔ 날씨 때문에 공정이 꼬인 적이 있다
✔ 건설 법규·시방서를 빠르게 찾고 싶다
✔ 안전 TBM 자료를 매일 새로 만들기 번거롭다
✔ 발주처에게 공사 현황을 실시간으로 보여주고 싶다
✔ 준공도서 패키지를 한 번에 뽑고 싶다

3단계 기능 구성

CONAI는 Phase 1~3으로 나뉘며, 현재 모두 구현 완료 상태입니다.

Phase 1

기본 업무 자동화

• AI 작업일보 + PDF 출력
• Gantt 공정표 (CPM 자동 계산)
• 날씨 공정 경보 (기상청 연동)
• AI 검측요청서 (KCS 기반)
• 주간·월간 보고서 자동 초안
• 법규 Q&A (RAG 검색)
• 인허가 체크리스트 자동 도출
• 카카오톡 챗봇 연동

Phase 2

AI 에이전트 4인방

• GONGSA — 공정 관리
• PUMJIL — 품질 관리
• ANJEON — 안전 관리
• GUMU — 행정 관리
• EVMS (SPI·CPI 자동 산출)
• Vision AI (사진 분류·안전)
• 위험구역 Geofence 경보

Phase 3

완전 자동화

• 매일 07:00 아침 브리핑 자동 생성
• EVMS 자정 스냅샷 자동 저장
• 준공도서 ZIP 패키지 자동 생성
• 도면 vs 현장 사진 AI 대조
• 발주처 전용 읽기 포털
• HWP 출력 지원

AI 에이전트 4인방

CONAI의 핵심은 각자 전담 역할을 가진 Claude AI 에이전트 4명입니다. 에이전트는 제안하고, 현장소장이 결정합니다.

🏗 GONGSA (공사)

공정 관리 에이전트

매일 07:00 자동 공정 브리핑, 공기 지연 감지, 날씨 연동 작업 조정 제안

🔬 PUMJIL (품질)

품질 관리 에이전트

시공 전 KCS 체크리스트 자동 발송, 현장 사진 1차 판독, 시험 기한 추적

🦺 ANJEON (안전)

안전 관리 에이전트

위험 공정 사전 경보, TBM 자료 자동 생성, 중대재해처벌법 Q&A

📝 GUMU (공무)

행정 관리 에이전트

인허가 능동 추적, 기성청구 시기 제안, 주간 보고서 초안 자동 생성

콘크리트 타설 당일에 concrete_pour 시나리오를 실행하면 GONGSA → PUMJIL → ANJEON이 순서대로 공정 확인, 체크리스트 발송, TBM 자료를 자동으로 처리합니다.

5분 세팅으로 시작

git clone https://github.com/sinmb79/convai.git
cd convai
cp backend/.env.example backend/.env
# .env에 API 키 입력 후
docker compose up -d
docker compose exec backend alembic upgrade head

필수 API 키는 Anthropic(Claude), Supabase(DB), 기상청 OpenAPI 세 가지입니다. Supabase와 기상청 API는 무료로 사용할 수 있습니다.

자동화 스케줄

시간	작업
매 3시간	날씨 데이터 수집 + 공종별 경보 평가
매일 00:05	EVMS 스냅샷 자동 저장 (공정률·SPI·CPI)
매일 07:00	GONGSA 아침 공정 브리핑 자동 생성

기술 스택

Python 3.11 FastAPI Next.js 15 Claude Sonnet API PostgreSQL + pgvector Supabase WeasyPrint APScheduler Docker Compose 카카오 Skill API 기상청 OpenAPI Voyage AI (RAG)

MIT 라이선스 무료 공개

CONAI의 전체 소스코드는 MIT 라이선스로 공개됩니다. 개인·기업·건설사 모두 제약 없이 사용, 수정, 상업적 활용이 가능합니다. AI가 생성하는 모든 문서는 현장 책임자의 검토를 거쳐야 합니다. CONAI는 현장소장을 대체하는 것이 아니라, 반복 잡무를 대신 처리해 판단에 집중할 수 있게 돕는 도구입니다.

📦 GitHub에서 받아보기

전체 소스코드 · Docker 세팅 · API 문서 · 설치 가이드 포함

sinmb79/convai 바로가기 →

#CONAI #건설AI #건설관리자동화 #AI에이전트 #작업일보자동화 #현장소장AI #오픈소스 #Python #FastAPI #ClaudeAPI #22BLabs #The4thPath