VibeSys: Generating Bespoke Systems with AI Agents
An agentic framework that generates bespoke systems from application requirements, workload characteristics, and the underlying hardware.
One of VibeSys's first initiatives is VibeServe, which asks whether AI agents can generate a bespoke LLM serving system for each model, workload, and hardware target. The figures, blog post, and paper below document that initiative.
Updates
- 2026-05 — VibeServe blog post: Let AI Agents Write Your Serving Stack with VibeServe.
- 2026-05 — Paper released on arXiv: 2605.06068.
Introduction
VibeSys explores a broader approach to systems development: use application requirements, workload characteristics, and hardware capabilities as the inputs to an agentic search process that creates a purpose-built system. Each target defines its own implementation contract, correctness checks, and performance benchmark, allowing VibeSys to work across domains rather than assuming a single runtime, programming language, or deployment shape.
The framework is organized as a multi-agent optimization loop. An outer loop plans the search over system designs using persistent state such as issues, memory, and git history, while an inner loop implements candidates, validates correctness against target-specific requirements, and measures performance on the target workload and hardware. VibeServe is the first substantial initiative built on this approach; its serving-focused results include predicted-output decoding, hybrid prompt caching, streaming ASR, constrained JSON decoding, multimodal inference, and Apple Silicon deployment.
Architecture
The framework factors the work along two axes:
- Outer loop — a fresh designer selects one falsifiable causal hypothesis from git history, profiling evidence, and durable roadmap/progress memory, then hands it off until it is proven, disproven, or otherwise terminated.
- Inner loop — a hypothesis-scoped implementer session edits the candidate, chooses targeted experiments and parameter ranges, and reports whether to continue or nominate the result.
- Independent judge — a fresh, read-only reviewer checks the implementation, activation evidence, invariants, and reward-hacking risks at a sparse cadence. After a PASS, the framework—not an agent—runs and records the canonical accuracy and benchmark commands.
- Performance evaluator — profiles the implementation (Nsight Systems, PyTorch profiler) and feeds bottleneck hints into future design decisions.
- Skills library — Agent Skills entries distilled from existing serving engines and research literature (continuous batching, paged-KV, FlashInfer/FlashAttention, MLX, hybrid-cache management, …). New model families, hardware platforms, and optimization techniques are added by writing a skill, not by modifying the framework.
- Execution environment: an isolated runtime view where candidate source is writable while evaluator-owned inputs and framework metadata are read-only and integrity-checked. It exposes the target hardware (local CUDA, Modal, Docker, or Apple Silicon) plus profilers.
Each round is recorded in git and a framework-owned audit. Provisional rounds remain explicitly unreviewed; only judge-approved candidates receive official accuracy and performance results.
Quickstart
Install Python 3.12+, Git, and uv. Linux also
requires bubblewrap; macOS includes the required sandbox-exec command. Then
install VibeSys:
uv tool install vibesys
Install and authenticate a supported coding-agent CLI. For Codex CLI, run
codex login; see the CLI reference for other supported
agents.
From the root of the project you want to optimize, add a named task under
.vibesys/tasks/:
.vibesys/tasks/<task>/OBJECTIVE.mddescribes what to optimize and the constraints the result must preserve..vibesys/tasks/<task>/vibesys.input.tomlidentifies the problem domain and the programs that check correctness and benchmark performance.agent.tomloptionally selects the coding agent, model, and hardware backend. Keep it untracked.
For example:
[model]
name = "gpt-5.4"
[agent]
backend = "cli"
cli_provider = "codex"
[backend]
name = "cpu"
See examples/ for complete objectives and manifests across data
structures, model serving, and microservices.
Run from the project root:
cd /path/to/my-project
vibesys validate --task my-task
vibesys --task my-task --max-rounds 4
The directory must be its Git repository root, or outside Git so VibeSys can
initialize a repository. An existing repository needs a baseline commit and a
clean worktree. See Running VibeSys for copied
projects, legacy input bundles, Docker, Modal, remote repositories, resume, and
alternate search loops. The CLI reference documents every
flag. Contributor setup belongs in docs/development.md.
Citation
If you use the VibeServe initiative in your research, please cite:
@misc{kamahori2026vibeserveaiagentsbuild,
title={VibeServe: Can AI Agents Build Bespoke LLM Serving Systems?},
author={Keisuke Kamahori and Shihang Li and Simon Peter and Baris Kasikci},
year={2026},
eprint={2605.06068},
archivePrefix={arXiv},
primaryClass={cs.AI},
url={https://arxiv.org/abs/2605.06068},
}
Metadata
Release files for vibesys 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| vibesys-0.1.1-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details for vibesys-0.1.1-py3-none-manylinux_2_28_x86_64.whl |
| vibesys-0.1.1-py3-none-manylinux_2_28_aarch64.whl | Python 3 | none | Linux glibc 2.28+ ARM64 | Details for vibesys-0.1.1-py3-none-manylinux_2_28_aarch64.whl |
| vibesys-0.1.1-py3-none-macosx_13_0_x86_64.whl | Python 3 | none | macOS 13.0+ x86-64 | Details for vibesys-0.1.1-py3-none-macosx_13_0_x86_64.whl |
| vibesys-0.1.1-py3-none-macosx_13_0_arm64.whl | Python 3 | none | macOS 13.0+ ARM64 | Details for vibesys-0.1.1-py3-none-macosx_13_0_arm64.whl |
Total release size: 166.9 MB
Release files / vibesys-0.1.1-py3-none-manylinux_2_28_x86_64.whl
| Download URL | vibesys-0.1.1-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 51.0 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
aacf9d3a80c772e50ddde07e7c8fe2afca24c71344a8f66635b19ad6e4aa29e4
|
|
BLAKE2b-256 checksum How to use checksums |
0c13b08b992f037be5f71502f59fd2dd5ace973bd10ec29ad0cd2de63afda4a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.
Transparency logRelease files / vibesys-0.1.1-py3-none-manylinux_2_28_aarch64.whl
| Download URL | vibesys-0.1.1-py3-none-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 50.5 MB |
| Tags | Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
7a2b544bc9b99a032c94bcc6fc382770345ce46d6164564bcb18ee60f75bb5cf
|
|
BLAKE2b-256 checksum How to use checksums |
3aab4b4ebf188671872eeb5f0d56375ccb8320a13077a3c8a03aba1c71f999e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.
Transparency logRelease files / vibesys-0.1.1-py3-none-macosx_13_0_x86_64.whl
| Download URL | vibesys-0.1.1-py3-none-macosx_13_0_x86_64.whl |
|---|---|
| Size | 33.8 MB |
| Tags | Python 3 macOS 13.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
83d73dbb066f9bc7eae09f929019ea5d4867dd6ac26250dbfccbcf46ca55d7e1
|
|
BLAKE2b-256 checksum How to use checksums |
572047b9bed43dec79871a614bcb1aa3e09287bacab4fb7c93eca34dc91526c5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.
Transparency logRelease files / vibesys-0.1.1-py3-none-macosx_13_0_arm64.whl
| Download URL | vibesys-0.1.1-py3-none-macosx_13_0_arm64.whl |
|---|---|
| Size | 31.5 MB |
| Tags | Python 3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
8606805b58cdbb202311c143338f5817d546d66228df61ad5d4ffc1d6c2d30dc
|
|
BLAKE2b-256 checksum How to use checksums |
77469f0e8f693e79c0f4f82186f1d6e21e1a02e065896b12eea8fac5b861d67d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.
Transparency logSecurity for vibesys 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 4 files in this release have been uploaded with provenance metadata.
Attestation for vibesys-0.1.1-py3-none-manylinux_2_28_x86_64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.