AI-Surface
Find and govern AI attack surfaces in application code at PR time. Free, OSS, runs offline.
파일 탐색기
최종 버전 다운로드 (.zip)- entry.py
- bug.yml
- config.yml
- false-negative.yml
- false-positive.yml
- feature-request.yml
- example-pr-check.yml
- publish.yml
- security-scan.yml
- self-test.yml
- dependabot.yml
- pull_request_template.md
- overview-governance.png
- state-of-ai-surface.png
- surface-map.png
- ARCHITECTURE.md
- CI_INTEGRATION.md
- COMPLIANCE.md
- DETECTORS.md
- LANGUAGE_SUPPORT.md
- PRIVACY.md
- SCHEMA_v1.md
- STATE_OF_AI_SURFACE.md
- bedrock.tf
- vllm-embeddings.yaml
- api.py
- chat_agent.py
- knowledge_base.py
- llm_service.py
- orders_mcp_server.py
- support_workflow.py
- .env.example
- .mcp.json
- litellm.config.yaml
- README.md
- circleci.yml
- gitlab-ci.yml
- pre-commit-hook.sh
- pr-comment.md
- report.json
- report.md
- terminal.txt
- basic.yml
- custom-risk-threshold.yml
- fail-on-risk.yml
- scan-on-main.yml
- README.md
- demo_report.json
- generate_demo.py
- generate_sample.py
- sample_report.json
- __init__.py
- api_patterns.py
- known_mcps.json
- model_patterns.py
- owasp_llm.py
- registry.py
- risk_definitions.py
- secret_patterns.py
- __init__.py
- __init__.py
- agent_frameworks.py
- ai_infra.py
- api_endpoints.py
- env_keys.py
- llm_sdks.py
- mcp_audit.py
- mcp_servers.py
- model_gateways.py
- vector_rag.py
- __init__.py
- cyclonedx_reporter.py
- json_reporter.py
- markdown_reporter.py
- sarif_reporter.py
- terminal_reporter.py
- ai-bom.json
- app.js
- index.html
- README.md
- report.json
- styles.css
- __init__.py
- markdown_safety.py
- specs.py
- walk.py
- __init__.py
- audits.py
- cli.py
- cross_promo.py
- diff.py
- dispositions.py
- frameworks.py
- observability.py
- orchestrator.py
- oversight.py
- pii.py
- repo.py
- types.py
- ui_server.py
- verdicts.py
- anthropic_tools.py
- claude_agent_sdk_app.py
- claude_agent_sdk_app.ts
- clean.py
- crewai_research.py
- langchain_refund.py
- openai_agents_refund.py
- strands_param_hydration.py
- foo.py
- docker-compose.yml
- Dockerfile
- Dockerfile
- values.yaml
- deployment.yaml
- deployment.yaml
- main.tf
- routes.js
- main.py
- openapi.yaml
- main.py
- .mcp.json
- openapi.yaml
- .env
- .envrc
- .env
- .env.production
- foo.py
- config.yaml
- app.py
- .env
- .mcp.json
- api.py
- assistant.ts
- knowledge.py
- prompts.py
- support_agent.py
- agent.py
- client.ts
- utils.py
- summarize.py
- README.txt
- regular_app.py
- mcp.json
- mcp_orders_server.py
- __init__.py
- test_agent_frameworks.py
- test_ai_infra.py
- test_api_endpoints.py
- test_audits.py
- test_cli.py
- test_cross_promo.py
- test_cross_promo_bridges.py
- test_cyclonedx.py
- test_diff.py
- test_dispositions.py
- test_e2e.py
- test_edge_cases.py
- test_env_keys.py
- test_frameworks.py
- test_gate.py
- test_golden_app.py
- test_governance_flag.py
- test_init_command.py
- test_llm_sdks.py
- test_markdown_safety.py
- test_mcp_audit.py
- test_mcp_reach.py
- test_mcp_servers.py
- test_model_gateways.py
- test_observability.py
- test_orchestrator.py
- test_oversight.py
- test_pii.py
- test_redos.py
- test_repo_scan.py
- test_reporters.py
- test_sarif.py
- test_ui_server.py
- test_vector_rag.py
- test_verdicts.py
- test_walk.py
- .gitignore
- .pre-commit-hooks.yaml
- action.yml
- CHANGELOG.md
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- Dockerfile
- LICENSE
- pyproject.toml
- README.md
- SECURITY.md
# 설치 가이드
1. 코드 내려받기
git clone https://github.com/apisec-inc/AI-Surface
깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.
cd AI-Surface
방금 내려받은 프로젝트 폴더 안으로 이동합니다.
2. 공식 설치 스크립트
쉬움 추천pipx install apisec-ai-surface
pipx로 격리된 환경에 CLI 도구를 설치합니다.
pip install apisec-ai-surface && ai-surface scan .
PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.
설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
3. Docker
쉬움사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
docker build -t ai-surface .
Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.
docker run -p 8080:80 ai-surface
빌드된 이미지를 실제 컨테이너로 실행합니다.
터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.
4. Python
쉬움사전 준비물
pip install apisec-ai-surface && ai-surface scan .
PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.
python -m venv .venv
파이썬 스크립트(또는 모듈)를 실행합니다.
pip install -e ".[dev]"
requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.
에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
// repository documentation
Was this content helpful?
(0 ratings)