Skip to main content

A supreme orchestrator for AI agents following the VibeSquad Master Blueprint.

Project description

🚀 VibeSquad (vibesquad)

The Supreme Orchestrator for High-Performance 1-Person Development Loops.

VibeSquad is a framework-agnostic orchestrator agent designed to manage multiple AI specialists (Agents) while enforcing strict minimalist standards, security, and modern UI/UX principles.


⚡ Quick Start (3-Minute Setup)

1. Installation

Install the package directly from your local source:

git clone https://github.com/your-username/vibesquad.git
cd vibesquad
pip install -e .

2. Basic Usage (Python)

You can integrate VibeSquad into any AI agent system or use it as a standalone prompt generator.

from vibesquad import VibeSquad

# Initialize the VibeSquad
commander = VibeSquad()

# 1. Get the Master Blueprint (System Instructions)
# (Logic: commander.blueprint contains the content)
print("VibeSquad Master Blueprint Loaded Successfully!")

3. Command Interface

Run the built-in terminal interface to start orchestrating:

dotcom

🏛️ Core Standards (The Master Blueprint)

When VibeSquad orchestrates a project, it strictly enforces the following rules defined in the blueprint.md:

🎨 1. Modern UI/UX Standards

  • Minimalist Design: Zero clutter, focus on core user intent.
  • Tailwind-First: Direct, utility-first styling for speed and consistency.
  • Performance: Optimized assets and fast load times.

🛡️ 2. Security & Engineering

  • Secure by Design: Input validation, CSRF protection, and secure API handling as defaults.
  • PHP Laravel / Modern Stacks: Leveraging robust frameworks for backend stability.
  • Scalable Architecture: Clean code structure that grows with your project.

⚙️ 3. 1-Person Dev Optimization

  • Unified Vision: Planning, Development, and QA are synchronized under one command.
  • Auto-Documentation: Every phase generates standardized reports for future maintenance.

📂 Project Structure

  • vibesquad/: Core logic and built-in Master Blueprint.
  • examples/: Ready-to-use scripts for various frameworks.
  • tests/: Reliability check suite.

📜 License

Distributed under the MIT License. See LICENSE for more information.


🤝 Contributing

Authorized by KSC. For contributions or bug reports, please open an issue in the repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vibesquad-1.1.0.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vibesquad-1.1.0-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file vibesquad-1.1.0.tar.gz.

File metadata

  • Download URL: vibesquad-1.1.0.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for vibesquad-1.1.0.tar.gz
Algorithm Hash digest
SHA256 d1e322af5af946d8c9ae99e2584c832da9b66a383fb98481218c3e8e76cfb517
MD5 f0aae73cd80e53e4fbf2751844869f68
BLAKE2b-256 56bbbdfad6723d02ca3989760852a725c654f6023684e208513b2dda361be883

See more details on using hashes here.

File details

Details for the file vibesquad-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: vibesquad-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for vibesquad-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bf8ddd6b6deb239f6aea2479d0ccd7a7a98fa951561e34c09df407c36183c5c9
MD5 24f27862b29b1e7a1898a7ac64d4be05
BLAKE2b-256 7f1da94340dde9cb7e1fd618e7fd2b83d80e23fd0d82fe99ebc0a9e3a9acfec1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page