connectai/README.md

# Astra

Astra는 로컬 인프라를 기반으로 작동하는 자비스형 프로젝트 운영 비서입니다. VS Code 환경에서 프로젝트 기억, 제2뇌, 코드/문서 맥락, 도구 실행을 하나의 목소리로 연결해 사용자의 생각 정리와 다음 행동 결정을 돕습니다.

## 핵심 기술 아키텍처

본 시스템은 대규모 코드베이스와 지식 기반을 효율적으로 처리하기 위해 설계된 세 가지 핵심 기술 스택을 기반으로 합니다.

### 1. 벡터화된 고성능 추론 엔진
NumPy 기반의 행렬 연산을 활용하여 기존의 반복문 기반 검색 방식의 병목을 해결했습니다. 특징 매칭 알고리즘의 시간 복잡도를 선형 수준으로 최적화하여 대규모 데이터셋에서도 실시간에 가까운 응답 속도를 보장합니다.

### 2. Actor/Queue 기반 비동기 작업 관리
비동기 메시지 큐와 워커 풀 아키텍처를 도입하여 작업 수집과 실행 프로세스를 완전히 분리했습니다. 이를 통해 트래픽 급증 시에도 시스템 부하를 안정적으로 분산하며, 서비스 중단 없는 연속적인 작업 처리가 가능합니다.

### 3. 실시간 SLO 모니터링 및 성능 추적
모든 핵심 추론 경로에 대해 지연 시간을 실시간으로 측정합니다. P95 지연 시간을 포함한 정밀한 성능 지표를 분석하여 설정된 성능 목표(SLO)를 상시 준수하도록 설계되었습니다.

## 주요 기능 및 권한

시스템은 사용자의 명시적인 승인 하에 다음과 같은 로컬 시스템 제어 권한을 행사합니다.

| 작업 범주 | 설명 |
| :--- | :--- |
| 파일 시스템 제어 | 파일 및 디렉토리의 생성, 수정, 삭제를 수행하여 프로젝트 구조를 관리합니다. |
| 지식 기반 분석 | 프로젝트 코드 및 로컬 지식 문서를 읽어 개발 맥락을 정밀하게 파악합니다. |
| 터미널 명령 실행 | 빌드, 테스트, 배포 등 개발 워크플로우에 필요한 셸 명령을 직접 수행합니다. |
| 자율 워크플로우 | 다중 에이전트 협업 시스템을 통해 복잡한 요구사항을 단계별 실행 계획으로 분해하여 처리합니다. |

## 설치 방법

### 패키지 설치
1. 배포된 v2.32.0 이상의 VSIX 파일을 다운로드합니다.
2. VS Code에서 명령 팔레트를 실행한 후 Extensions: Install from VSIX를 선택하여 설치를 완료합니다.

### 소스 빌드 환경
```bash
git clone https://github.com/g1nations/locallm.git
cd locallm
npm install
npm run compile
npx vsce package
```

## 데이터 보안 및 개인정보 보호

Astra는 100% 로컬 추론 환경에서 작동하도록 설계되었습니다.

- 모든 연산은 사용자 로컬 머신의 자원을 사용하여 처리됩니다.
- 코드 및 지식 데이터는 외부 클라우드 서버로 전송되지 않습니다.
- 인터넷 연결 없이 오프라인 환경에서도 모든 핵심 기능을 사용할 수 있습니다.

---
Designed for high-performance autonomous engineering.
Copyright (C) Astra. All rights reserved.