guardana/guardana

어떤 프로젝트인가요?

핵심 기능

• 01안전하지 않은 pickle 및 torch.load 사용을 포함해 코드와 모델 아티팩트를 오프라인으로 정적 스캔
• 02LLM 엔드포인트, MCP 서버, A2A 에이전트를 능동적으로 점검
• 03OpenTelemetry GenAI 스팬과 자체 추적 형식 분석
• 04발견 사항, 검증되지 않은 점검 항목, 오류, 커버리지 공백을 구분해 보고
• 05문서화된 CI 종료 코드와 함께 SARIF, JSON, JUnit, 텍스트 형식으로 출력
• 06diff 명령으로 저장된 실행 결과 비교

활용 사례

• 배포 전에 Hub에서 가져온 모델 파일을 대상으로 CI 파이프라인 통과 여부 결정
• LLM 애플리케이션 저장소의 SARIF 결과를 GitHub code scanning에 업로드
• 스테이징 LLM 또는 MCP 서버를 대상으로 예약된 능동 점검 실행
• 새 요청을 보내지 않고 프로덕션 애플리케이션이 이미 기록한 답변 평가

빠른 시작

1. 1

   uv로 설치 없이 스캔

   uvx --from guardana-cli guardana scan .
2. 2

   uv로 패키지 설치

   uv add guardana-cli
3. 3

   또는 pip로 패키지 설치

   pip install guardana-cli
4. 4

   오프라인에서 첫 실행을 시험할 스타터 프로젝트 만들기

   guardana init --starter first-run

사용 전 알아둘 점

• !베타 버전이므로 동작이 변경될 수 있습니다.
• !액티브 프로브는 대상에 실제 요청을 보내고 비용이 발생할 수 있으므로 먼저 예산을 설정해야 합니다.
• !인라인 가드레일, 범용 SAST 또는 CVE 스캐너, 규정 준수 인증 도구가 아닙니다.

토픽

자주 묻는 질문

guardana은(는) 무엇인가요?

AI 모델 파일, 코드, 실시간 LLM/에이전트/MCP 엔드포인트와 저장된 에이전트 추적을 검증하고 발견 사항과 점검 공백을 보고하는 오픈소스 CLI 및 라이브러리입니다. Guardana는 AI 시스템을 다루는 보안 및 플랫폼 엔지니어를 위한 검증 도구입니다. 오프라인으로 코드와 모델 아티팩트를 스캔해 안전하지 않은 pickle 로드, weights_only 없이 사용하는 torch.load, 모델 설정의 원격 코드 실행, 의심스러운 import 등의 위험을 찾습니다. 실시간 모델 엔드포인트, MCP 서버, A2A 에이전트를 능동적으로 점검하고 OpenTelemetry GenAI 또는 자체 형식으로 기록된 추적도 분석할 수 있습니다.

guardana은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

guardana은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

guardana은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. guardana의 마지막 커밋은 2026년 10월 21일입니다.

guardana은(는) 어디에 사용할 수 있나요?

배포 전에 Hub에서 가져온 모델 파일을 대상으로 CI 파이프라인 통과 여부 결정 LLM 애플리케이션 저장소의 SARIF 결과를 GitHub code scanning에 업로드 스테이징 LLM 또는 MCP 서버를 대상으로 예약된 능동 점검 실행 새 요청을 보내지 않고 프로덕션 애플리케이션이 이미 기록한 답변 평가

guardana는 어떻게 설치하나요?

uv로 설치 없이 스캔: uvx --from guardana-cli guardana scan . uv로 패키지 설치: uv add guardana-cli 또는 pip로 패키지 설치: pip install guardana-cli 오프라인에서 첫 실행을 시험할 스타터 프로젝트 만들기: guardana init --starter first-run

guardana은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/guardana/guardana