Bennettxai/FounderOS

개인 사업자를 위한 운영 체제(Operating System): AI 지원 '부서'들로 비즈니스를 운영하는 명령 센터.

이것은 전체를 하나로 유지하는 사람을 위해 만들어졌습니다: 프리랜서, 솔로프리너(solopreneur), 솔로 창업가(solo founder) 또는 한 사람이 여전히 핵심 역할을 수행하는 소규모 팀. 당신이 방향을 설정하면 AI 에이전트들이 부서를 담당하고, 존재하는 모든 직원은 같은 대시보드에 연결됩니다.

Founder OS는 비즈니스를 운영할 때 필요한 탭, 도구 및 정신적 부담(mental overhead)을 하나의 화면으로 통합합니다: 통일된 커뮤니케이션(comms), 고객 퍼널(client funnel), 소셜 성장(social growth), 재무(finances), 지식 그래프(knowledge graph), 그리고 각각 실제 업무를 담당하는 이름이 지정된 AI 에이전트 목록.

직접 라이브로 구축하고 가이드가 필요합니까? 그것이 바로 이 코호트(cohort)의 목적입니다: founderos.sh

Founder OS v1은 Next.js + SQLite 앱이었습니다. v2는 동일한 운영자 UI를 유지하며 BusinessOS 스택에서 실행됩니다:

운영자(operator)는 /os에서 라이브로 확인합니다.

BusinessOS가 제공하는 나머지 모든 것들(워크스페이스, 역할, 팀, 모듈 데스크톱, 터미널)도 함께 제공됩니다.

마지막 v1 릴리스는 v1-nextjs 태그가 지정되어 있습니다.

사전 요구 사항 (macOS 기준):

brew install node@22 go postgresql@17 pgvector redis elixir python
corepack enable && corepack prepare [email protected] --activate

스키마는 vector 확장이 필요합니다. Homebrew의 pgvector 바틀(bottle)은 현재 Postgres 릴리스(17/18)를 위해 빌드되므로, 이를 postgresql@17과 페어링하거나 다른 Postgres에 대해 pgvector를 직접 빌드하고, 또는 BUSINESSOS_PG_BIN=/path/to/pg/bin으로 일치하는 설치본을 가리키도록 설정하십시오.

그런 다음:

BUSINESSOS_HEADLESS=1 make dev-local # Postgres, Redis, Optimal Engine, backend, frontend
# (데스크톱 앱도 열려면 BUSINESSOS_HEADLESS=1을 제거하세요)
open http://localhost:5273/register # 로컬 계정 생성
...

make demo

네 개의 워크스페이스(HQ, Vantage, Launchpad Cohort, Personal)를 생성하고, 데모에 심어진 데이터(seeded data)를 Postgres에 로드하며 Optimal Engine의 지식으로 가져옵니다. 이 과정은 반복 가능(idempotent)하여, 다시 실행해도 데모가 새로고침되고 날짜는 오늘로 이동합니다. 브라우징을 위해 자격 증명(credentials)이 필요하지 않습니다.

포트(Ports)는 .env.dev에 있습니다.

; make dev-local-status

실행 중인 상태를 보여주고,
make dev-local-stop

이를 중지합니다. 플랫폼 자체의 설정 방법은 docs/BUSINESSOS.md를 참조하세요.

사이드바 또는 명령 팔레트(Cmd/Ctrl + K; 숫자 1–9는 처음 아홉 개의 보기로 이동)를 사용하여 탐색할 수 있습니다.

데모가 심어진 데이터 덕분에 살아있는 것처럼 보이지만, 모든 보기는 실제 설치에서 사용하는 동일한 경로를 읽어오며, 모든 커넥터는 가짜 녹색 불이 아닌 자신의 정직한 상태(connected, not_configured 또는 error)를 보고합니다.

프론트엔드/src/routes/(founderos)/os/ SvelteKit 라우트, 뷰별로 구성
프론트엔드/src/lib/founderos/ 뷰, 키트 (slab, charts, motion), 크롬
d에스크톱/백엔드-go/internal/founderos/
...

데이터는 founderos_*에 저장됩니다.

Postgres 테이블은 워크스페이스별로 스코핑(scoping)됩니다. 지식은 Optimal Engine에 존재합니다: 에이전트들이 소스, 신호 및 보류 중인 클레임을 작성하며; 사실(facts)은 승격 게이트를 거치므로 메모리가 더 많은 에이전트가 작성해도 신뢰성을 유지합니다.

안전 스위치. FOUNDEROS_WRITES=1
은 외부 쓰기 작업(발송, 게시물, 결제 등)을 허용하며; FOUNDEROS_CRONS=1
은 예약된 에이전트 실행을 허용합니다. 둘 다 켜지 않으면 비활성화되어 있습니다.

커넥터들은 프로세스 환경 변수(~/.founderos/.env)나 커넥션 보드를 통해 심어진 키를 읽습니다. 사용자의 다른 장치에 있는 것은 아무것도 읽지 않습니다. 절대 키를 커밋하지 마세요. .env* 파일은 gitignore 됩니다.

make test # Go + 프론트엔드 스위트
cd frontend && npx vitest run src/lib/founderos
cd desktop/backend-go && go test ./internal/founderos/... 

go 테스트는 이 체크아웃의 개발용 Postgres(.env.dev에 있는 POSTGRES_PORT)에 임시 데이터베이스를 생성합니다; 다른 것을 사용하려면 FOUNDEROS_PG_ADMIN_URL을 설정하세요.
실패하는 테스트부터 작성하세요.

Founder OS v2는 Roberto H. Luna와 Miosa 팀이 구축한 BusinessOS 및 Optimal Engine을 기반으로 합니다. 이 스택을 사용한다면, 그들의 레포지토리를 스타(star)해주세요.

MIT, LICENSE를 참조하세요.