Somi-Project/Somi

자신의 기기에서 자체 AI 운영 체제를 실행하세요.

SOMI는 데이터를 클라우드 플랫폼에 맡기고 싶지 않은 사람들을 위해 구축된, 완전한 셀프 호스팅(self-hosted) 및 로컬 우선(local-first)의 AI 에이전트 프레임워크입니다.

이는 일반 사용자에게 강력하게 느껴지고 개발자에게 신뢰감을 주도록 설계되었습니다:

• 로컬 채팅, 메모리, 리서치, 코딩, OCR, 음성 및 자동화 기능
• 전용 스튜디오와 제어 표면을 갖춘 데스크톱 우선 운영 경험
• 승인 인지(approval-aware) 도구, 샌드박스 실행 경로, 감사 가능한(auditable) 액션
• 여전히 일반 소비자급 하드웨어에서 실행되는 모듈식 아키텍처

구독료 없음. 강제적인 SaaS 없음. 원격 에이전트 서비스에 대한 숨겨진 의존성 없음.

중요한 점

SOMI는 실제로 함께 살아갈 수 있는 AI를 원하는 사람들을 위해 구축되었습니다: 로컬적이고, 유능하며, 감사 가능하고, 사용하기 즐거운 AI입니다.

팁

이러한 종류의 프로젝트가 처음이라면 바로 'Quick Start'로 이동하세요. 프레임워크로서 평가하려는 경우, 'Repo Tour For Developers'를 확인하세요.

• 로컬 AI 비서

• 코딩 파트너

• 리서치 분석가

• OCR 및 문서 추출 도구

• 음성 지원 데스크톱 도우미

• Telegram 연결 에이전트

• 자동화 엔진

• 새로운 도구와 스킬을 구축하기 위한 모듈형 AI 프레임워크

• 자체 하드웨어에서 AI 실행

• 데이터 로컬 유지

• 데스크톱, 채팅, Telegram 또는 음성을 통해 SOMI와 대화

• 하나의 시스템에서 리서치, 요약, 추출, 정리 및 자동화

• 터미널에 머무는 대신 미래지향적이면서도 실용적인 GUI 사용

• PySide6 데스크톱 셸

• 모듈형 에이전트 런타임

• 도구 레지스트리 및 실행 백엔드

• 코딩 작업 공간 및 보호된 실행

• 워크플로우 런타임 및 서브에이전트

• 온톨로지, 상태 평면(state plane), 제어실(control room)

• 로컬 우선 음성, OCR, 브라우저 자동화 및 리서치 스택

• 릴리스 게이트, 프리즈 아티팩트, 리플레이 하네스 및 보안 감사 도구

SOMI는 단순한 CLI 프로젝트가 아닙니다. 다음과 같은 전용 운영자 인터페이스(operator surfaces)를 갖춘 데스크톱 셸을 포함합니다:

• 제어실(Control Room)

• 코딩 스튜디오(Coding Studio)

• 리서치 스튜디오(Research Studio)

• 음성 제어(Speech controls)

• 노드 관리자(Node Manager)

• 지속적인 로컬 채팅 세션

• 영구 메모리 및 회상 기능

• 압축 인지 히스토리 처리

• 구성 가능한 페르소나 및 모델 라우팅

• 관리형 코딩 작업 공간

• Python 우선, 다중 언어 지원 워크플로우

• 보호된 파일 작업 및 런타임 액션

• 벤치마크 및 검증 루프

• 코딩 중심 스튜디오 UI

• 웹 및 문서 리서치

• 증거 그래프(evidence graphs)

• 내보내기 번들(export bundles)

• 모순 인지 합성(contradiction-aware synthesis)

• 로컬 우선 리서치 오케스트레이션

• 문서 OCR

• 스키마 기반 추출

• 표 및 양식 휴리스틱

• 스프레드시트 및 다운스트림 워크플로우용 내보내기 준비 결과물

• 로컬 TTS(Text-to-Speech) 및 STT(Speech-to-Text) 파이프라인

• pyttsx3 및 로컬 whisper 기반 흐름

• 데스크톱 음성 제어 및 테스트 도구

• 모듈형 도구 레지스트리

• 스킬 마켓플레이스 및 신뢰 메타데이터

• 워크플로우 매니페스트(workflow manifests)

• 자동화 런타임

• 스킬 초안 작성 및 승인을 통한 자체 확장 경로

• approval-aware execution

• audit trails

• scoped remote behavior

• gateway and node mesh foundations

• security audit and release gate tooling

• Python 3.11+

• Git

• Ollama를 로컬에서 실행 (running locally at)
  http://127.0.0.1:11434

권장 사항 (Recommended):

• 최신 CPU 및 최소 16GB RAM
• 더 빠른 로컬 추론을 위한 NVIDIA GPU
• 일부 고급 코딩 및 브라우저 워크플로우를 위한 Node.js

git clone https://github.com/Somi-Project/Somi.git
cd Somi
python -m venv .venv

Windows:

.venv\Scripts\activate
pip install -r requirements.txt

Linux / macOS:

source .venv/bin/activate
pip install -r requirements.txt

하드웨어에 맞는 선택적 PyTorch 설치 (Optional PyTorch install for your hardware):

CPU:

pip install torch torchvision

CUDA 예시 (CUDA example):

pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121

여기서 cu121을 사용자의 CUDA 버전에 맞는 빌드로 교체하세요.

ollama pull dolphin3:latest
ollama pull stable-code:3b
ollama pull glm-ocr:latest
...

팁 (Tip)

더 나은 개인 웹 검색 및 연구 성능을 위해 SOMI를 적절하게 구성된 SearXNG 인스턴스와 함께 사용하세요. 커뮤니티 설정 가이드: SearXNG guide (링크는 원문에 없으나, 문맥상 추가)

python somicontroller.py

참고 (Note)

메인 경험만 원한다면 데스크톱 앱부터 시작하세요. SOMI가 무엇을 하도록 설계되었는지 가장 쉽게 느낄 수 있는 방법입니다.

CLI 유틸리티를 선호하는 경우:

python somi.py doctor
python somi.py release gate
python somi.py freeze

SOMI는 단일 거대 에이전트 루프가 아니라 로컬 AI 운영 스택으로 구축되었습니다.

Desktop / Chat / Telegram / Speech / Nodes
|
Gateway
...

핵심 설계 기둥 (Core design pillars):

• 일반 사용자에게 가능한 최고의 사용자 경험 제공
• 기본적으로 보안을 고려함 (security-aware by default)
• 소비자 하드웨어에서 신뢰성 높음
• 매일 사용하기에 충분히 빠름
• 핵심 코드를 재작성할 필요 없이 확장 가능하도록 모듈화됨

🧩 개발자 뷰를 원하시나요? (Want the developer view?)

SOMI를 프레임워크로 평가하는 경우, 다음이 가장 중요한 진입점입니다:

somicontroller.py

• 데스크톱 애플리케이션 진입점
  somi.py

• doctor, security, release, replay, 그리고 freeze CLI agents.py

• 에이전트 호환성 래퍼 및 런타임 바인딩 agent_methods

• 에이전트 동작 모듈 분할 gui

• PySide6 애플리케이션 표면 workshop/toolbox

• 도구 스택 및 런타임 기능 workshop/skills

• 기술(skills), 마켓플레이스, 신뢰, 그리고 자체 확장 execution_backends

• 실행 라우팅 및 백엔드 계약 workflow_runtime

• 경계가 지정된 워크플로우 러너 ontology

• 타입이 지정된 운영 그래프 gateway

• 채널 및 노드 대면 제어 표면 speech

• 로컬 음성 런타임 docs/architecture/SYSTEM_MAP.md

• 아키텍처 백본 docs/architecture/CONTRIBUTOR_MAP.md

• 새로운 기여자에게 가장 빠른 경로 docs/release/FRAMEWORK_FREEZE.md

• 현재 준비 상태 스냅샷

SOMI는 현재 다음을 포함합니다:

• PySide6 기반 로컬 데스크톱 GUI
• 코딩 작업 공간 및 보호된 코드 실행
• 증거 그래프 내보내기 기능을 갖춘 연구 슈퍼 모드
• OCR 프리셋 및 구조화 추출
• 도킹(doctoring) 도구를 갖춘 로컬 음성 파이프라인
• 워크플로우 런타임 및 서브 에이전트
• 제어실 및 관측 가능 표면
• 스킬 포지, 스킬 마켓플레이스, 신뢰 레이블링
• 노드 메시 및 페어링 기반
• 온톨로지 기반 동작 및 인간의 감독
• 릴리스 게이트, 프레임워크 동결(freeze), 리플레이 하네스, 보안 감사 도구

SOMI는 힘을 가진 것이 비용이 없다고 가장하지 않으면서 강력하도록 구축되었습니다.

이는 다음을 의미합니다:

• 민감한 실행 경로에 대한 승인
• 원격 동작에 대한 명시적인 신뢰 상태
• 감사 가능한 작업
• 모듈식 격리 경계
• 실용적일 때 항상 로컬 우선 기본값

SOMI는 무모한 자율성을 추구하지 않습니다. 사용 가능한 주권(usable sovereignty)을 추구합니다.

SOMI는 사람들이 실제로 소유하는 실제 기계를 위해 구축되었습니다.

이는 프레임워크가 다음을 중심으로 설계되었음을 의미합니다:

• 로컬 Ollama 호스팅 모델
• 제한된 메모리 및 컨텍스트 처리
• 점진적으로 활성화할 수 있는 모듈식 구성 요소
• 프로슈머급 및 게이머급 하드웨어에서의 실용적인 성능

SOMI의 이점을 얻기 위해 서버 랙이 필요하지 않습니다.

SOMI는 로컬 데스크톱 우선 경험을 제공하는 크로스 플랫폼 프레임워크로 구축되고 있습니다.

현재 개발은 Windows에서 가장 많이 이루어졌으며, 아키텍처와 패키징 방향은 Windows, Linux 및 macOS 지원을 목표로 합니다.

• Telegram: https://t.me/+0ug5tDcPBXNjMTMx
• Twitter / X: https://x.com/SomiProject

가장 도움이 되는 기여:

• 온보딩(onboarding) 및 문서 개선
• 더 강력한 모듈형 도구와 기술
• 벤치마크 개선
• 성능 및 하드웨어 튜닝
• UI 다듬기(polish)
• 플랫폼 패키징 및 설치 프로그램 작업

SOMI가 시간을 절약해 주거나, 프로젝트에 영감을 주거나, 당신이 존재하기를 원하는 AI 미래와 같은 느낌을 준다면, 레포지토리에 별점을 주고 공유해주세요.

SOMI는 사람들이 실제로 사용할 수 있도록 만들어진 것이 목표입니다.