Hackathon - Do the impossible with AI

🛜 Wifi

• AIUG-Guest
• aiusergroup

We are happy to welcome you to our hackathon to celebrate our first official launch!! 🎉

• Don't hesitate to give us some feedback, and a star 🌟 on github! --> RIGHT HERE <--
• You can also bump a like 🤝 on devhunt --> RIGHT HERE <--

Organized in partnership with:

• BlackboxAI - BlackboxAI is the world’s most advanced AI coding ecosystem, with an IDE.
• Codiris - AI-native Product Development Environment
• The AI Collective - A non-profit, grassroots community uniting 100,000+ pioneers – founders, researchers, operators, and investors – exploring the frontier of AI in major tech hubs worldwide

---

Resources

📖 Need help getting your Blackbox API key? See BLACKBOX_API_SETUP.md

Support

Since we are in early stage, you might encounter issues. Don't hesitate to reach out to us for debugging

• Support Channel: join our discord. We have created a channel for the hackathon.
• Look for Thomas, Louis or Robin. We have Pipelex merch and a french accent, you can't miss us.

Documentation

• Documentation: [https://docs.pipelex.com]
• API Reference: [https://docs.pipelex.com/pages/api/]

Examples

• 📋 Project Ideas & Examples - 20 education-focused project ideas you can build
• Pipelex COOKBOOK

---

⚠️⚠️⚠️ IMPORTANT: Focus on ONE Feature! ⚠️⚠️⚠️

You have only 2 hours and 30 minutes.

• Pick ONE concrete problem to solve.
• Think about the data right from the beginning.
• Build ONE workflow that actually works
• Integrate it into a simple, functional app
• Make it demo-ready

Remember: A single feature that works beautifully is infinitely better than five half-baked ideas. Focus, ship, and shine! 🎯

Setup

(OPTIONAL) STEP 0: Install BlackBox IDE

• Signup to blackbox.ai
• Before you start building, you need to install the BlackBox IDE - your AI-powered development environment.

Download the BlackBox IDE

---

---

STEP 1 1: Setup

OPTION 1 (No docker, more setup): Requires a Python frontend

Build your frontend with Streamlit or Gradio or else.

Step 1: Install Pipelex

python3 -m venv .venv
source .venv/bin/activate
pip install pipelex

Step 2: Configure your environment variables

Create a .env file in your project directory and add your BlackboxAI API key: If you don't have one, come to us.

BLACKBOX_API_KEY=your_blackbox_api_key

Step 3: Initialize Pipelex

pipelex init

• Please activate the telemetry by choosing Anonymous or identified! This is really helful for us.
• When it comes to choosing the backend, choose "BlackboxAI" (number 11).

Step 4: Configure the routing profile

Open the file .pipelex/inference/routing_profiles.toml and modify the active value:

active = "all_blackboxai"

Step 5: Verify your setup

pipelex doctor

Step 6: Import the rules

You need the AI editor rules to be imported in your workspace. To do so, run the following command:

pipelex kit rules

Run this command to make sure everything is configured correctly.

Step 7: Get your BLACKBOX API KEY

📖 See BLACKBOX_API_SETUP.md for detailed instructions on how to get your API key.

Step 8: Build your workflow

pipelex build pipe "Create me a workflow that..."

Help here to execute the workflow Pipelex documentation to:

Step 9: Build your frontend

Use Streamlit or Gradio to create a UI that calls your Pipelex workflows.

✅ No API server needed - Pipelex runs directly in your Python code!

---

OPTION 2 (Docker for the Pipelex API) - TypeScript Frontend

Build your frontend with Next.js, Vue.js, React, etc.

📖 Need help getting your Blackbox API key? See BLACKBOX_API_SETUP.md

Step 1: Run the Pipelex API to run your workflows

Requirements: Docker installed (Install Docker)

Run the Pipelex API:

API_KEY=pipelex DON'T CHANGE THIS. It will be the token used for the API on your frontend. Since your API will run locally, its safe to use a static key.

BLACKBOX_API_KEY=your-blackbox-api-key-here Your BlackboxAI API key. If you don't have one, come to us.

docker run --name pipelex-api -p 8081:8081 \
  -e API_KEY=pipelex \
  -e BLACKBOX_API_KEY=your-blackbox-api-key-here \
  pipelex/pipelex-api:latest

✅ The API will be available at http://localhost:8081

Here is the API documentation: Pipelex API Documentation

Step 2: Import AI EDITOR Rules

You need the AI EDITOR rules to be imported in your workspace. To do so, run the following command:

You can find the necessary rules in the main repository:

• If you use Cursor, the rules are here: Cursor Rules: Create a file .cursor/rules/write_pipelex.mdc in the root of your project and copy paste the rules into it.
• If you use Copilot, the rules are here: Copilot Rules: Create a file .github/copilot-instructions.md in the root of your project and copy paste the rules into it.
• If you use CLAUDE CODE , the rules are here: CLAUDE CODE Rules: Create a file CLAUDE.md in the root of your project and copy paste the rules into it.
• If you use Windsurf, the rules are here: Windsurf Rules: Create a file .windsurfrules.md in the root of your project and copy paste the rules into it.
• You can find the AGENT.md rules here: AGENT.md Rules: Create a file AGENT.md in the root of your project and copy paste the rules into it.

How to Submit

https://www.pipelex.com/vibe-ai-workflows-hackathon---submissions

You will need to provide by 9pm:

1. GitHub Repository Link

   • Make sure your repository is public or accessible

2. Demo Video Link (YouTube, Loom, or similar)

   • Maximum 3 minutes
   • Show your workflow in action
   • Demo the app functionality

---

Good luck, and happy hacking! 🎉