⚡ Brahma AI Evo — 자율 데스크톱 운영 지능

스스로 진화하는 멀티모달 개인 AI 데스크톱 환경

PyQt6

Gemini 2.5

MCP

Platform

🌌 개요 (Overview)

Brahma AI Evo는 실제 JARVIS 워크스테이션처럼 작동하도록 구축된 차세대 데스크톱 지능입니다. 실시간 양방향 네이티브 음성 오디오, 멀티모달 컴퓨터 비전, 자율 코드 자체 진화(self-evolution), 그리고 로컬 시스템 오케스트레이션 기능을 결합하여 사용자의 Windows PC를 스스로 진화하는 커맨드 센터로 변환합니다.

⚡ Brahma AI Evo의 새로운 기능 (What's New)

1. 🔌 홀로그래픽 하드웨어 어셈블러 및 회로 HUD

• 화면 및 음성 부품 인식: Brahma는 컴퓨터 비전을 통해 화면을 스캔하거나 음성 명령문("Brahma, how to connect DHT11 to Arduino Pro Mini")을 구문 분석하여 마이크로컨트롤러(Arduino Uno, Pro Mini, ESP32), 센서(DHT11, HC-SR04 초음파, 서보 모터) 및 수동 부품을 인식합니다.
• 인앱 인터랙티브 팝업: Brahma 내부에서 컴팩트하고 다크 글래스모픽한 팝업 오버레이를 열어 다음을 보여줍니다:
  • 핀아웃 레이블(VCC, DATA, GND, 2, p8, p9)이 있는 부품 카드.
  • 실시간으로 흐르는 흰색 전자 펄스 점이 있는 애니메이션 빛나는 네온 SVG 와이어.
  • 번호가 매겨진 핀 버블(①, ②, ③, ④, ⑤).
  • 작동 전압 안전 경고 및 플래시 준비가 된 Arduino C++ 펌웨어.

2. 🧬 Project Ultron — 자가 진화형 자율 스킬 배양소

• 실시간 코드 합성: 내장된 도구 키트 외부의 작업을 수행하도록 요청받으면, Brahma는 역량 격차를 식별하고 features/ 디렉터리에 완전히 새로운 Python 도구를 직접 작성하며, 이를 격리된 샌드박스("The Crucible") 내부에서 테스트한 후 애플리케이션을 재시작하지 않고 동적으로 자동 등록합니다.
• 영구 저장소 (Persistent Vault): 생성된 모든 스킬은 features/ 디렉터리에 저장되며 자동으로 실시간 로딩됩니다.

3. 🛡️ 사전 예방적 자동 복구 엔진 (Proactive Auto-Heal Engine)

• 자가 수리 코드베이스: 백그라운드 감시 시스템이 런타임 예외를 포착하고, LLM 기반의 근본 원인 추론(root-cause reasoning)을 사용하여 트레이스백을 분석하며, 오류가 발생한 코드에 동적 패치를 적용하고, 어시스턴트를 충돌시키지 않으면서 대화형 HUD 복구 텔레메트리 카드를 제시합니다.

4. 🌊 실시간 FFT 오디오 파형 및 다이내믹 글로우 코어

• 실시간 물리 주파수 스펙트럼: 커맨드 바(Command Bar)에 직접 내장된 9밴드 반응형 오디오 시각화기입니다.
• 다이내믹 상태 발광 (Dynamic State Glow States):
  • 🟡 골드: 대기 / 청취 중
  • 🔵 청록색/파란색: 음성 캡처 중 (실시간 에너지 파동)
  • 🟣 보라색: Brahma 추론 / 사고 중
  • 🟢 녹색: 도구 실행 / 시스템 동작
  • 🔴 빨간색: 음소거

5. 🧩 시각적 사고 과정(Chain-of-Thought) 실행 추적기

• 에이전트형 단계별 HUD 카드: 채팅 버블 내부에 직접 삽입된 접을 수 있는 실행 추적 기록입니다.
• 서브초 단위의 실행 지연 시간 표시칩([180ms], [120ms]), 상태 배지 (COMPLETED), 그리고 매개변수와 원시 JSON 페이로드를 위한 확장 가능한 [검사(Inspect)] 드로어가 제공됩니다.

6. 🌐 인터랙티브 3D 홀로글로브 및 지리공간 레이더

• 3D 지구 및 2D 거리 지도: 실시간 대원형 비행 경로, 실시간 항공기 레이더 추적, 회전 안내 고속도로 운전 경로, 그리고 주변 POI(병원, 주유소, ATM) 스캔 기능을 갖춘 WebGL 구체 지구본입니다.

7. 🎵 공식 Spotify MCP 서버 통합

• 안정적이고 신뢰할 수 있는 음악 재생, 앨범/아티스트 검색, 큐 제어, 볼륨 조절, 그리고 PC와 모바일 간의 활성 기기 핸드오버를 위해 개방형 **Model Context Protocol (MCP)**을 기반으로 구축됨.

8. ⚙️ 중앙 집중식 API 설정 허브

• 연결된 모든 서비스에 대한 전용 카드를 갖춘 완벽한 설정 UI:
  • Google Gemini API (실시간 음성 및 비전)
  • Spotify MCP (Client ID 및 Client Secret)
  • OpenRouter / Anthropic
  • 날씨 및 레이더 API
  • Instagram 및 스마트 홈
  • 즉각적인 라이브 연결 테스트 버튼.

🛠️ 핵심 기능(Core Capabilities)

🎙️ 멀티모달 네이티브 오디오 및 비전

• Gemini 2.5 Flash Native Audio를 통한 500ms 미만의 저지연 대화.
• 실시간 문서 분석, 코드 디버깅, 하드웨어 구성 요소 인식을 위한 라이브 웹캠 및 데스크톱 화면 비전 기능.

🖥️ 심층 Windows 데스크톱 오케스트레이션

• 애플리케이션 및 프로세스 관리자: 메모리를 많이 사용하는 백그라운드 프로세스를 실행, 제어, 검사 및 일시 중지.
• 시스템 설정: Wi-Fi 토글, 볼륨 조정, 화면 밝기, 다크/라이트 테마 변경, CPU/RAM/배터리 지표 모니터링.
• 스마트 창 제어: 여러 모니터를 가로질러 창을 최소화, 최대화, 타일 또는 배열.
• 클립보드 센트리: 복사된 텍스트/코드의 즉각적인 분석, 번역, 서식 지정 또는 디버깅.

📄 자율 오피스 및 문서 아키텍트

• Word (.docx): 형식화된 전문 문서, 보고서 및 이력서 생성.
• Excel (.xlsx): 수식, 차트 및 재무 모델을 갖춘 복잡한 다중 시트 워크북 작성.
• PowerPoint (.pptx): 슬라이드 레이아웃, 타이포그래피 및 발표자 노트를 포함하여 브랜딩된 프레젠테이션 구축.
• PDF 스위트: PDF 결과물을 변환, 병합, 추출 및 조립.

📱 Brahma Connect (Android Companion)

• AI 전화 통화 프록시: Brahma가 수신되는 전화를 모니터링하고, 발신자와 대화하며, 회의록을 작성하고, 즉각적인 데스크톱 스크립트와 요약본을 제공합니다.
• 생태계 동기화 (Ecosystem Sync): 기기의 지리적 위치(geolocation), SMS 알림, 배터리 상태를 동기화합니다.

🏡 스마트 홈 허브 (Smart Home Hub)

• Tuya 및 Home Assistant와의 직접적인 통합을 통해 스마트 조명, 스마트 플러그, 에어컨 장치, 선풍기, 텔레비전 등을 제어할 수 있습니다.

🧠 장기 기억 및 정체성 (Long-Term Memory & Identity)

• 적응형 메모리 엔진(Adaptive memory engine)은 세션 전반에 걸쳐 개인 사용자 환경 설정, 진행 중인 프로젝트, 맞춤 지침을 저장합니다.

🚀 빠른 시작 (Quick Start)

필수 준비물 (Prerequisites)

• Windows 10 / 11 (64비트)
• Python 3.11 또는 Python 3.12
• Git
• 작동하는 마이크 및 스피커 (시각 정보(vision)용 웹캠은 선택 사항)
• Google Gemini API 키: Google AI Studio에서 받습니다.

설치 (Installation)

1. 저장소 복제 (Clone the repository):
   복사

git clone https://github.com/titechprabhasolutions/Brahma-Ai-Evo.git
cd Brahma-Ai-Evo

2. **자동 설정 실행 (Run the Automated Setup):**
   ```powershell
python setup.py

또는 포함된 배치 파일로 실행:

start_brahma.bat

3. API 키 구성 (Configure API Keys):
   • Brahma AI Evo를 실행합니다.
   • 상단 탐색 표시줄에서 설정(Settings) 아이콘을 클릭합니다.
   • 각 카드에 Gemini API 키와 선택적 자격 증명(Spotify MCP, 날씨 등)을 입력합니다.
   • **저장 및 연결(Save & Connect)**을 클릭합니다.

🎮 음성 및 명령어 치트 시트 (Voice & Command Cheat Sheet)

• 모든 장기 메모리(long-term memories), 자격 증명(credentials), 및 설정 파일은 로컬의 %LOCALAPPDATA%\ ext{BrahmaAI}\\에 저장됩니다.
• 외부 도구는 권한 센트리(permission sentries)와 격리된 Crucible 샌드박스를 통해 실행됩니다.
• 오디오 및 비디오 프레임은 활성 대화 세션 동안에만 스트리밍됩니다.

📄 라이선스 (License)

개인적 및 사적인 로컬 사용 전용 — 배포 금지.

본 프로젝트는 **Brahma AI Evo Source-Available 개인 사용 라이선스(Personal Use License)**에 따라 라이선스가 부여됩니다.

• ✅ 허용됨: 본 소프트웨어를 귀하의 개인 장치에서 사적, 개인적, 교육적 및 연구 목적으로 로컬에 다운로드, 클론, 검사, 빌드 및 실행할 수 있습니다.
• 🚫 엄격히 금지 (배포 불가): 본 소프트웨어, 저장소(repository), 바이너리 또는 파생 저작물을 어떠한 곳(다른 Git 호스트, 공개 저장소 또는 클라우드 플랫폼 포함)에도 배포, 재배포, 재업로드, 미러링, 공유, 전송, 서브라이선스 부여하거나 출판할 수 없습니다. 유일한 공식 배포 출처는 본 저장소입니다.
• 🚫 엄격히 금지 (상업적 사용 불가): 본 소프트웨어를 판매, 임대, 수익화, 번들링, 상업화하거나 유료 SaaS/클라우드 서비스로 호스팅할 수 없습니다.

전체 약관 및 법적 조건은 [LICENSE] 파일에서 확인하십시오. 상업적 라이선싱 문의는 Discord를 통해 연락 주십시오.