You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8ff880c
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: Cargo.toml
+3Lines changed: 3 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,9 @@ name = "mega2"
3
3
version = "0.40.15"
4
4
edition = "2024"
5
5
license = "MIT OR Apache-2.0"
6
+
description = "Monorepo engine and Git hosting server for AI agents: trunk-based storage, Git Smart HTTP, Git LFS, OCI registry, and Agent Session Capture"
Copy file name to clipboardExpand all lines: README.md
+35-4Lines changed: 35 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,33 @@
1
-
# mega2
1
+
# Mega2: Monorepo Engine and Git Server for AI Agents
2
+
3
+
> An open-source, trunk-based monorepo storage and Git hosting server written in Rust, with Git Smart HTTP, Git LFS, an OCI container registry, build-artifact storage, and Agent Session Capture.
2
4
3
5
English · [中文](README.zh.md)
4
6
7
+
[](#license)
The first-generation [Mega](https://github.com/web3infra-foundation/mega) established the foundation for our monorepo and Git-hosting platform. **Mega2 is the second-generation engine built for AI agents**, with two core capabilities: a **Monorepo engine** and **Agent Session Capture**.
6
11
7
12
The open-source edition of Mega2 runs in **trunk / storage-only** mode and does not include a Web UI or Change List. Mega2 provides the server-side monorepo storage and APIs; Libra provides a terminal interface for interactive browsing.
8
13
9
14
Start with the [Quick Start](docs/quick-start.md), then see the [documentation index](docs/README.md) for user, operator, and contributor guides. Repository and push behavior is covered in the [User Guide](docs/user-guide.md); contribution checks are in the [Contributing Guide](docs/contributing.md).
10
15
16
+
## At a glance
17
+
18
+
| Item | Details |
19
+
|---|---|
20
+
| What it is | Monorepo engine and Git hosting server for AI agents |
21
+
| Language | Rust (edition 2024), a single Cargo package `mega2`|
22
+
| Mode | Trunk / storage-only: `refs/heads/main` is the public trunk |
23
+
| Protocols and interfaces | Git Smart HTTP, read-only SSH, Git LFS, OCI Distribution (`/v2`), HTTP API |
24
+
| API docs | OpenAPI: `/api/openapi.json`; Swagger UI: `/swagger-ui`|
25
+
| Storage | Postgres for metadata; local filesystem or S3-compatible object storage for Git objects, LFS, artifacts, and images |
26
+
| Image | Docker Hub [`genedna/mega2`](https://hub.docker.com/r/genedna/mega2), default HTTP port `9000`|
27
+
| Not included | Web UI, Change List, multi-branch monorepo workflows |
28
+
| Companion tools |[Libra](https://libra.tools) (agent-side version control and terminal browser), [ScorpioFS](https://github.com/gitmono-dev/scorpiofs) (monorepo filesystem mount) |
29
+
| License | MIT OR Apache-2.0 |
30
+
11
31
## Recommended Agent setup
12
32
13
33
The best practice for agent-oriented monorepo development is to use **Mega2 + ScorpioFS + Libra** together:
@@ -39,7 +59,7 @@ Agent Session Capture is an optional HTTP capability, separate from Git push. Wh
39
59
40
60
## Quick start with Compose
41
61
42
-
The evaluation stack pulls the official release image from Docker Hub (`genedna/mega2:latest`) — no source build, no bootstrap. Pick the compose file for your platform (they differ in how artifact presigned URLs are made reachable from the host — see [`docs/deployment.md`](docs/deployment.md)):
62
+
The evaluation stack pulls the official release image from Docker Hub (`genedna/mega2:latest`) — no source build, no bootstrap. Pick the compose file for your platform (they differ in how artifact presigned URLs are made reachable from the host — see the [Deployment Guide](docs/deployment.md)):
docker compose -f linux-mega2-compose.yml up -d --wait
49
69
```
50
70
51
-
HTTP: `http://127.0.0.1:9000/`. This is a local-only anonymous setup (`push_auth=none`, bound to `127.0.0.1`); for token-based or shared deployments see the [Deployment Guide](docs/deployment.md). Start with the [`Quick Start`](docs/quick-start.md); for migration, LFS, OCI, and artifact examples, see [`Usage Recipes`](docs/recipes.md).
71
+
HTTP: `http://127.0.0.1:9000/`. This is a local-only anonymous setup (`push_auth=none`, bound to `127.0.0.1`); for token-based or shared deployments see the [Deployment Guide](docs/deployment.md) and [`docs/deploy-trunk.md`](docs/deploy-trunk.md). Start and push with the [Quick Start](docs/quick-start.md), then see [Usage Recipes](docs/recipes.md) for repository migration, LFS, OCI, and build-artifact examples.
52
72
53
73
For local development and tests, see the [Contributing Guide](docs/contributing.md).
Details: [`AGENTS.md`](AGENTS.md) and the [Contributing Guide](docs/contributing.md).
101
+
Details: [`AGENTS.md`](AGENTS.md), the [Contributing Guide](docs/contributing.md), and [`docs/plan/README.md`](docs/plan/README.md).
82
102
83
103
## Documentation
84
104
@@ -91,3 +111,14 @@ Details: [`AGENTS.md`](AGENTS.md) and the [Contributing Guide](docs/contributing
91
111
|[`docs/contributing.md`](docs/contributing.md)| Local development, contribution process, code conventions, and integration tests |
92
112
93
113
Configuration, deployment, architecture, and subsystem references are linked from the [documentation index](docs/README.md).
114
+
115
+
## License
116
+
117
+
Mega2 is dual-licensed under MIT and Apache-2.0 (`MIT OR Apache-2.0`); you may choose either license:
118
+
119
+
-[MIT License](LICENSE-MIT)
120
+
-[Apache License 2.0](LICENSE-APACHE)
121
+
122
+
Third-party code copied directly into this repository, if any, is declared in [`LICENSE-THIRD-PARTY`](LICENSE-THIRD-PARTY).
123
+
124
+
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project, as defined in the Apache-2.0 license, shall be dual-licensed as above, without any additional terms or conditions.
0 commit comments