setup

Configure a modular RAG project from a clean checkout.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/yao9906/visrag --skill setup-yao9906
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/yao9906/visrag/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/yao9906/visrag --skill setup-yao9906

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the friction of first-time project setup by guiding you through provider selection, API key configuration, dependency installation, config generation, and dashboard launch, while also diagnosing and retrying startup failures when something goes wrong.

Core Features & Use Cases

  • Interactive configuration: Helps users choose LLM, embedding, vision, and rerank providers based on their environment and needs.
  • Project bootstrap: Generates the correct settings file, prepares required folders, installs dependencies, and verifies critical imports.
  • Recovery and extension: Automatically diagnoses launch issues with retry loops and can scaffold unsupported providers for the project’s plugin architecture.
  • Use case: A new user can go from a clean clone to a working dashboard without manually reading setup docs or editing configuration by hand.

Quick Start

Ask the setup skill to configure the project from scratch, generate the settings, install dependencies, and launch the dashboard.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a modular RAG project from a clean checkout?

You can configure a modular RAG project by interactively selecting LLM, embedding, vision, and rerank providers. The setup process then generates the required YAML settings, installs dependencies, and launches the dashboard automatically.

What is the best way to bootstrap a RAG application environment and generate settings?

The best way to bootstrap a RAG environment is through an interactive setup flow that validates your Python runtime and virtual environment. It generates the correct YAML settings file, prepares folders, and verifies critical imports for a reliable launch.

Can I scaffold unsupported providers into my project's plugin architecture?

Yes, you can scaffold unsupported providers into your project's plugin architecture. The setup process supports provider onboarding by generating the necessary scaffolding to integrate new LLM or embedding services into your workflow.

Why does my RAG dashboard launch fail on the first run, and how can I recover?

Dashboard startup failures often stem from missing dependencies or invalid credentials. The setup process automatically diagnoses launch issues using retry loops, validates your configuration, and applies automated recovery to resolve startup errors.

What prerequisites do I need to complete project bootstrap and dependency installation?

To complete project bootstrap, you need a validated Python runtime and a virtual environment. The setup process requires these prerequisites to install dependencies reliably, generate YAML settings, and verify critical imports before launch.

Does the setup process support automated recovery from environment initialization failures?

Yes, the setup process supports automated recovery from environment initialization failures. It diagnoses startup issues by running retry loops, re-validating credentials, and checking generated configurations to ensure the dashboard launches correctly.