README.md

metadata

title: fabric_to_espanso
app_file: gradio_app_query_only.py
sdk: gradio
sdk_version: 5.12.0

Fabric to Espanso Converter

A Python application that bridges Fabric prompts with Espanso by managing and converting prompts through a vector database.

Features

• Store and manage Fabric prompts in a Qdrant vector database
• Convert stored prompts into Espanso YAML format for system-wide usage
• Semantic search functionality to find relevant prompts based on their meaning
• Web interface for easy interaction with the prompt database

Prerequisites

• Python 3.11
• Qdrant vector database server (local or cloud)
• Obsidian with MeshAI plugin installed
• Windows (for PowerShell script) or Linux/WSL for direct execution

Installation

1. Install Obsidian and the MeshAI plugin
2. In Obsidian, create the following folder structure:

   Extra/
   └── FabricPatterns/
       ├── Official/  # For downloaded Fabric patterns
       └── Own/       # For your custom additions
   

3. Clone this repository
4. Install dependencies using PDM:

   pdm install
   

5. Configure your Qdrant server connection in the application settings

Usage

Linux/WSL

Run the Streamlit application directly:

./src/search_qdrant/run_streamlit.sh

Windows

Create a PowerShell script with the following content to start the application:

# Start WSL process without showing window
$startInfo = New-Object System.Diagnostics.ProcessStartInfo
$startInfo.Filename = "wsl.exe"
# Use -c flag to let the command use the WSL2 Ubuntu folder system and not the Windows
$startInfo.Arguments = "bash -c ~/Tools/pythagora-core/workspace/fabrics_processor/src/search_qdrant/run_streamlit.sh"
$startInfo.UseShellExecute = $false
$startInfo.RedirectStandardOutput = $true
$startInfo.RedirectStandardError = $true
$startInfo.WindowStyle = [System.Diagnostics.ProcessWindowStyle]::Hidden
$startInfo.CreateNoWindow = $true

# Start the process
try {
    $process = [System.Diagnostics.Process]::Start($startInfo)
    Start-Sleep -Seconds 5
    
    # Check if Streamlit is actually running
    $streamlitRunning = Test-NetConnection -ComputerName localhost -Port 8501 -WarningAction SilentlyContinue
    
    if ($streamlitRunning.TcpTestSucceeded) {
        Start-Process "msedge.exe" "--app=http://localhost:8501"
    } else {
        Write-Error "Failed to start Streamlit application"
    }
} catch {
    Write-Error "Error starting Streamlit: $_"
}

This script will:

1. Start the Streamlit server if it's not already running
2. Open the application in Microsoft Edge in app mode
3. Automatically handle server startup and connection

Dependencies

• ipykernel >= 6.29.5
• markdown >= 3.7
• pyyaml >= 6.0.2
• qdrant-client >= 1.12.1
• fastembed >= 0.4.2
• streamlit >= 1.41.1
• pyperclip >= 1.9.0
• regex >= 2024.11.6

License

This project is licensed under the MIT License.