https://github.com/javredstone/mycelium

Mycelium is an autonomous agent system that prevents engineering knowledge loss as teams and codebases evolve. It infers who understands what in a codebase, where knowledge is fragile, and acts directly inside GitLab to stabilize it.
https://github.com/javredstone/mycelium

docker fastapi gemini gitlab-mcp google-adk mongodb-atlas mongodb-mcp nextjs vertex-ai

Last synced: 2 days ago
JSON representation

Mycelium is an autonomous agent system that prevents engineering knowledge loss as teams and codebases evolve. It infers who understands what in a codebase, where knowledge is fragile, and acts directly inside GitLab to stabilize it.

• Host: GitHub
• URL: https://github.com/javredstone/mycelium
• Owner: JavRedstone
• License: other
• Created: 2026-05-16T04:13:02.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-06-10T03:53:30.000Z (15 days ago)
• Last Synced: 2026-06-10T05:20:47.355Z (15 days ago)
• Topics: docker, fastapi, gemini, gitlab-mcp, google-adk, mongodb-atlas, mongodb-mcp, nextjs, vertex-ai
• Language: Python
• Homepage: https://mycelium-ui.vercel.app
• Size: 12.6 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Mycelium: Continuity Engine

![Mycelium Banner](docs/mycelium-banner.png)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

[![Devpost](https://img.shields.io/badge/Devpost-Mycelium-003E54)](https://devpost.com/software/mycelium-x4myeu)

![Architecture](docs/mycelium-architecture.png)

Mycelium is an autonomous agent system that prevents engineering knowledge loss as teams and codebases evolve. It infers who understands what in a codebase, where knowledge is fragile, and acts directly inside GitLab to stabilize it.

Built for the **Google Cloud Rapid Agent Hackathon 2026** using Vertex AI, ADK, Gemini, GitLab MCP, and MongoDB MCP. Runs an 8-stage autonomous pipeline: Observe → Model → Analyze → Decide → Act → Reflect → Persist → Summary.

---

## Docs

| Document | Description |

|---|---|

| [docs/SETUP.md](docs/SETUP.md) | Prerequisites, environment config, local run, webhooks, and deployment |

| [docs/ABOUT.md](docs/ABOUT.md) | Project writeup: inspiration, design, challenges, and roadmap |

| [docs/TECH.md](docs/TECH.md) | Full technology stack: all frameworks, services, and libraries used |

| [docs/PROJECT_INFO.md](docs/PROJECT_INFO.md) | Full project overview: design decisions, pipeline stages, agent architecture, and roadmap |

| [docs/HACKATHON.md](docs/HACKATHON.md) | Hackathon compliance requirements and partner integration notes |

---

## Repository layout

```

mycelium/

├── docs/                   # Project documentation

│   ├── SETUP.md            # Setup guide: local run, environment, deployment

│   ├── ABOUT.md            # Project writeup: inspiration, design, challenges, roadmap

│   ├── TECH.md             # Full technology stack reference

│   ├── PROJECT_INFO.md     # Full design and architecture reference

│   ├── HACKATHON.md        # Hackathon compliance requirements

│   └── draw.io/            # Architecture diagrams

├── mycelium/               # Backend: FastAPI + ADK pipeline agents

├── mycelium-ui/            # Frontend: Next.js monitoring UI

├── deploy.py               # Cloud Run deployment helper

└── LICENSE                 # Apache 2.0

```

### Backend: [`mycelium/`](mycelium/)

FastAPI service hosting the 9-stage pipeline, ADK agents, MCP connectors, and MongoDB knowledge graph driver.

### Frontend: [`mycelium-ui/`](mycelium-ui/)

Next.js dashboard for live pipeline monitoring, agent activity, knowledge graph visualization, and configuration.

### Deployment: [`deploy.py`](deploy.py)

Cloud Run deployment script for both the backend API and the UI.