README

Describe what you want. Vigen builds it.

Vigen is a modern PHP framework built around AI-first development and vibe coding. Instead of hand-writing controllers, models, migrations, and routes, you describe the outcome you want and Vigen's AI engine analyzes your project, plans the change, generates or modifies the necessary files, validates the result, and fixes what it finds broken.

Vibe. Build. Evolve.

Quick start

Starting a brand new project (recommended)

composer global require vigenphp/installer
vigen create my-app
cd my-app
composer install
php vigen serve   # if you chose GUI
php vigen chat "Create a user management system"   # if you chose CLI

vigen create asks three questions - chat interface, default AI provider, and model - then scaffolds the whole project (folders, composer.json, .env, your project's own vigen entry point) in one go. See vigenphp/installer.

Adding Vigen to an existing PHP project

composer require vigenphp/vigen
php vigen init

Composer will ask whether to trust Vigen's plugin (it publishes the vigen script below, nothing more):

Do you trust "vigenphp/vigen" to execute code and control other plugins?

Answer y, or pre-approve it in composer.json:

"config": {
    "allow-plugins": {
        "vigenphp/vigen": true
    }
}

This creates a vigen file in your project root - your equivalent of Laravel's artisan. From then on:

php vigen init

walks you through setup:

Choose chat preferred:
  > CLI
    GUI

Which default AI Provider:
  > Ollama (Offline)
    OpenAI
    Claude
    Gemini

Which model to use:
  > qwen2.5-coder:14b
    qwen2.5-coder:7b
    deepseek-coder-v2:16b
    codellama:13b

It writes your answers to .env and scaffolds a fresh Vigen project (app/, routes/, database/, config/, .vigen/).

Chose CLI? Talk to your project directly:

php vigen chat "Create a simple employee management application with employees, departments, CRUD operations, validation, and search."

Chose GUI? Launch the built-in chatbox:
```
php vigen serve
```
then open http://127.0.0.1:8808.

Either way, no manual file creation - Vigen determines the implementation.

Prefer not to trust the plugin, or it didn't run (e.g. --no-plugins)? vendor/bin/vigen works identically as a fallback.

Supported AI providers

Ollama (local models, first-class)
OpenAI
Claude
Gemini

Switching providers is a .env change - never a code change.

CLI and GUI, one engine

vigen chat "Add authentication with login and registration"

The same AI engine also powers a minimal built-in GUI chatbox. Neither interface implements its own AI logic.

Status

Vigen is in early MVP development. See docs/ for usage documentation and CHANGELOG.md for progress.

License

MIT. See LICENSE.

vigenphp / vigen

Package info

Security

Statistics