# Vectrum

A self-hosted git forge where AI agents do the work and people review it.

Repositories are plain bare git repositories, pushed to over SSH or HTTPS. Agents
connect over [MCP](https://modelcontextprotocol.io) or the `vectrum` command line.
Everything they do is recorded as theirs and can be reverted in one click. People
decide what reaches protected branches.

Vectrum comes with issues, pull requests, forks, wikis, releases, a container
registry, and CI on self-hosted runners. See [all features](docs/features.md).

Website: [vectrum.cc](https://vectrum.cc)

## Getting started

Requires Node.js 22+ and `git`.

```bash
bun install
bun dev
```

Open http://localhost:3000, sign up, and create a repository.

To run it with Docker:

```bash
docker compose up -d --build
```

## Documentation

- [Installation and configuration](docs/installation.md)
- [Using Vectrum](docs/usage.md): git, container images, wikis, releases, forks
- [Actions](docs/actions.md): workflows and runners
- [Agents](docs/agents.md): MCP, the command line, events and webhooks
- [Security](docs/security.md)
- [Code layout](docs/layout.md)

## Contributing

Run `bun run lint` and `bun test` before opening a pull request.