Name: Setup
Author: unicorn-plugins

搜索技能.../

Setup | Skills Pool

ulw

git clone https://github.com/langgenius/dify.git {설치_위치}

cd {설치_위치}/docker
cp .env.example .env

cd {설치_위치}/docker
docker compose up -d

from config import DifyConfig
from dify_client import DifyClient

config = DifyConfig()
client = DifyClient(config)
# _ensure_authenticated()가 자동 호출됨

# 설치된 플러그인 목록 조회
plugins = await client.list_plugins()

# Groq 플러그인이 없으면 설치
if not any("groq" in p.get("plugin_id", "") for p in plugins.get("plugins", [])):
    # 1) 마켓플레이스 API에서 최신 identifier 동적 조회
    import httpx
    async with httpx.AsyncClient(timeout=15.0) as http:
        resp = await http.post(
            "https://marketplace.dify.ai/api/v1/plugins/batch",
            json={"plugin_ids": ["langgenius/groq"]},
        )
        uid = resp.json()["data"]["plugins"][0]["latest_package_identifier"]

    # 2) 플러그인 설치 요청
    result = await client.install_marketplace_plugin([uid])

    # 3) 비동기 설치 완료 대기 (최대 120초, 10초 간격 폴링)
    import asyncio
    for _ in range(12):
        await asyncio.sleep(10)
        resp = await client._request("GET", "/workspaces/current/plugin/tasks")
        tasks = resp.get("tasks", [])
        if not tasks:
            break  # 태스크가 비어있으면 설치 완료
        plugin_status = tasks[0]["plugins"][0]["status"]
        if plugin_status == "success":
            break
        if plugin_status == "failed":
            raise Exception(f"Groq 플러그인 설치 실패: {tasks[0]['plugins'][0].get('message', '')}")

credentials = {"api_key": "{사용자_입력_API_KEY}"}

# 1) credentials 검증
await client.validate_provider_credentials("langgenius/groq/groq", credentials)

# 2) 검증 성공 시 저장
await client.save_provider_credentials("langgenius/groq/groq", credentials)

DIFY_API_BASE_URL=http://localhost/console/api
[email protected]
DIFY_PASSWORD=your_password

cd {ABRA_PLUGIN_DIR}/gateway
python -m venv .venv
# Windows
.venv\Scripts\activate && pip install -r requirements.txt
# macOS/Linux
source .venv/bin/activate && pip install -r requirements.txt

# Windows
{ABRA_PLUGIN_DIR}\gateway\.venv\Scripts\python {ABRA_PLUGIN_DIR}\gateway\tools\dify_cli.py list
# macOS/Linux
{ABRA_PLUGIN_DIR}/gateway/.venv/bin/python {ABRA_PLUGIN_DIR}/gateway/tools/dify_cli.py list

{
  "permissions": {
    "allow": [
      "Read({PLUGIN_CACHE_DIR}/**)",
      "Write({PLUGIN_CACHE_DIR}/**)",
      "Edit({PLUGIN_CACHE_DIR}/**)",
      "Bash(python {PLUGIN_CACHE_DIR}/**)",
      "Bash(python3 {PLUGIN_CACHE_DIR}/**)"
    ],
    "additionalDirectories": [
      "{PLUGIN_CACHE_DIR}"
    ]
  }
}

✅ Abra 플러그인 초기 설정 완료

📦 컨테이너 상태:
- {서비스명1}: Running
- {서비스명2}: Running
...

🤖 Groq 모델 설정: {완료 ✅ / 건너뜀 ⏭️ / 실패 ❌}

🌐 Dify 접속 URL: http://localhost

⚙️ `{설치_위치}/docker/.env` 설정: 완료
🐍 Python 가상환경: 완료
🔗 Dify 연결 테스트: {성공 ✅ / 실패 ❌}
🔐 Claude Code 권한 설정: 완료

⚠️  Claude Code를 재시작해야 권한 설정이 적용됩니다.
   재시작 후 /abra:scenario 명령으로 시작하세요.

📌 다음 단계:
1. Claude Code 재시작
2. /abra:scenario 명령으로 시나리오 생성 시작

🔑 비밀번호 초기화:
cd {설치_위치}/docker && docker compose exec api flask reset-password

문제	원인	해결 방법
Docker 미설치	Docker/Docker Compose 미설치	설치 URL 안내 후 사용자 설치 대기
포트 충돌 (80, 443)	다른 서비스가 포트 사용 중	기존 서비스 중지 또는 Dify 포트 변경 안내
컨테이너 시작 실패	메모리 부족, 설정 오류	`docker compose logs` 확인 안내
헬스체크 실패	컨테이너 부팅 지연	60초 대기 후 재시도 안내
Dify 로그인 실패	이메일/비밀번호 불일치	`{설치_위치}/docker/.env` 확인 또는 비밀번호 초기화 명령 안내
Groq 플러그인 설치 실패	네트워크 또는 Dify 버전 이슈	Settings > Model Providers에서 수동 설치 안내
Groq API Key 검증 실패	잘못된 API Key	https://console.groq.com/keys 에서 키 재발급 안내
Dify 연결 실패	접속 정보 불일치	``{설치_위치}/docker/.env` 확인 또는 비밀번호 초기화 안내

#	규칙
1	install.yaml을 참조하여 설치를 수행한다
2	Docker 및 Docker Compose 설치 여부를 먼저 확인한다
3	Docker Compose 실행 후 헬스체크를 수행한다
4	컨테이너 시작 실패 시 에러 로그를 확인하고 원인을 안내한다
5	초기 설정 안내(관리자 계정 생성 URL)를 반드시 제공한다
6	.env 파일 생성 전 사용자에게 접속 정보를 확인한다
7	Python 가상환경을 생성하고 requirements.txt 의존성을 설치한다
8	설치 완료 후 Dify 연결 테스트를 수행한다

#	금지 사항
1	Docker 미설치 상태에서 Docker Compose를 실행하지 않는다
2	기존 Dify docker/.env 파일을 덮어쓰지 않는다 (이미 존재하면 건너뜀)
3	헬스체크 실패를 무시하고 다음 단계로 진행하지 않는다
4	install.yaml에 정의되지 않은 도구를 설치하지 않는다
5	기존 `{설치_위치}/docker/.env` 파일을 사용자 확인 없이 덮어쓰지 않는다
6	Dify 연결 테스트 실패 시 무시하고 진행하지 않는다

항목	최소 사양
CPU	2 Core 이상
RAM	4 GiB 이상
Docker	설치 필요
Docker Compose	설치 필요

항목	최소 사양
CPU	2 Core 이상
RAM	4 GiB 이상
Docker	설치 필요
Docker Compose	설치 필요

변수명	설정값	용도
`CONSOLE_API_URL`	`http://localhost`	콘솔 API URL (OAuth 콜백 URI 생성에 필수)
`CONSOLE_WEB_URL`	`http://localhost`	콘솔 프론트엔드 URL
`APP_WEB_URL`	`http://localhost`	WebApp URL

Setup

목표

활성화 조건

작업 환경 변수 로드

사전 요구사항

워크플로우

Step 1: install.yaml 로드 (`ulw` 활용)

Step 2: Docker 확인 ( 활용)

Setup

목표

활성화 조건

작업 환경 변수 로드

사전 요구사항

워크플로우

Step 1: install.yaml 로드 (`ulw` 활용)

Step 2: Docker 확인 ( 활용)

Step 3: Dify 소스 확인 (`ulw` 활용)

Step 4: Dify Docker 환경 변수 파일 생성 (`ulw` 활용)

Step 5: Docker Compose 실행 (`ulw` 활용)

Step 6: 컨테이너 상태 확인 및 헬스체크 (`ulw` 활용)

Step 7: 초기 설정 안내 (`ulw` 활용)

Step 8: Groq 모델 설정 (`ulw` 활용)

Step 9: Dify 접속 정보 수집 (`ulw` 활용)

Step 10: Python 가상환경 생성 및 의존성 설치 (`ulw` 활용)

Step 11: 도구 동작 확인 (`ulw` 활용)

Step 12: Claude Code 권한 설정 (`ulw` 활용)

Step 13: 결과 보고

사용자 상호작용

문제 해결

스킬 부스팅

MUST 규칙

MUST NOT 규칙

검증 체크리스트

Bluebubbles

Add Tracing

Analytics Events

Add Expert

Arthas

Arthas Eagleeye Traceid

Setup

목표

활성화 조건

작업 환경 변수 로드

사전 요구사항

워크플로우

Step 1: install.yaml 로드 (ulw 활용)

Step 2: Docker 확인 ( 활용)

Setup

목표

활성화 조건

작업 환경 변수 로드

사전 요구사항

워크플로우

Step 1: install.yaml 로드 (ulw 활용)

Step 2: Docker 확인 ( 활용)

Step 3: Dify 소스 확인 (ulw 활용)

Step 4: Dify Docker 환경 변수 파일 생성 (ulw 활용)

Step 5: Docker Compose 실행 (ulw 활용)

Step 6: 컨테이너 상태 확인 및 헬스체크 (ulw 활용)

Step 7: 초기 설정 안내 (ulw 활용)

Step 8: Groq 모델 설정 (ulw 활용)

Step 9: Dify 접속 정보 수집 (ulw 활용)

Step 10: Python 가상환경 생성 및 의존성 설치 (ulw 활용)

Step 11: 도구 동작 확인 (ulw 활용)

Step 12: Claude Code 권한 설정 (ulw 활용)

Step 13: 결과 보고

사용자 상호작용

문제 해결

스킬 부스팅

MUST 규칙

MUST NOT 규칙

검증 체크리스트

Bluebubbles

Add Tracing

Analytics Events

Add Expert

Arthas

Arthas Eagleeye Traceid

Step 1: install.yaml 로드 (`ulw` 활용)

Step 1: install.yaml 로드 (`ulw` 활용)

Step 3: Dify 소스 확인 (`ulw` 활용)

Step 4: Dify Docker 환경 변수 파일 생성 (`ulw` 활용)

Step 5: Docker Compose 실행 (`ulw` 활용)

Step 6: 컨테이너 상태 확인 및 헬스체크 (`ulw` 활용)

Step 7: 초기 설정 안내 (`ulw` 활용)

Step 8: Groq 모델 설정 (`ulw` 활용)

Step 9: Dify 접속 정보 수집 (`ulw` 활용)

Step 10: Python 가상환경 생성 및 의존성 설치 (`ulw` 활용)

Step 11: 도구 동작 확인 (`ulw` 활용)

Step 12: Claude Code 권한 설정 (`ulw` 활용)