https://github.com/stewie-pixel/mirabile-cli
An AI agent insider that lives inside your terminal, build and manage your code
https://github.com/stewie-pixel/mirabile-cli
ai-agents api backend docker frontend jenkins python react reactjs typescript
Last synced: about 2 months ago
JSON representation
An AI agent insider that lives inside your terminal, build and manage your code
- Host: GitHub
- URL: https://github.com/stewie-pixel/mirabile-cli
- Owner: Stewie-pixel
- License: apache-2.0
- Created: 2026-04-02T08:12:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-27T23:29:20.000Z (about 2 months ago)
- Last Synced: 2026-04-29T14:37:29.429Z (about 2 months ago)
- Topics: ai-agents, api, backend, docker, frontend, jenkins, python, react, reactjs, typescript
- Language: Python
- Homepage:
- Size: 1.36 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
---
Mirabile
Transform your dream career into a structured roadmap with intelligent, personalized resources.
Explore the docs »
🎥 View Demo
·
Report Bug
·
Request Feature
## 📖 About The Project
**Mirabile** is an intelligent career roadmap platform that converts user-defined career goals into **structured learning paths** with **context-aware resources**.
Users can input goals such as:
* “Software Engineer at Google”
* “AI Engineer focusing on machine learning”
Mirabile will:
* Generate a **multi-phase roadmap**
* Adapt based on **role, domain, and company**
* Recommend **targeted resources**
* Enable **progress tracking and note-taking**
---
## 🎥 Demo
> 📌 Replace the link below with your actual demo video (YouTube / Drive)
🔗 Demo Video: https://your-demo-link.com
### What the demo should showcase:
* Pipeline execution (Jenkins stages)
* Roadmap generation
* Resource recommendations
* Deployment to staging/production
* Monitoring/logging output
---
## 🏗️ Architecture
```
Frontend (React)
↓
Backend API (Node.js / Express)
↓
Business Logic Layer
- Input Parser
- Roadmap Generator
- Company Intelligence Engine
- Resource Recommender
↓
Database (MongoDB / PostgreSQL)
```
---
## 🛠️ Built With
* React (Frontend)
* Node.js / Express (Backend)
* MongoDB / PostgreSQL (Database)
* Docker (Containerization)
* Jenkins (CI/CD Pipeline)
* SonarQube (Code Quality)
* Snyk / npm audit (Security Scanning)
* Prometheus / Grafana (Monitoring)
---
## 🚀 Getting Started
### Prerequisites
* Node.js (v18+)
* npm
* Docker (optional)
```sh
npm install npm@latest -g
```
---
### Installation
```sh
git clone https://github.com/Stewie-pixel/mirabile.git
cd mirabile
npm install
```
Create a `.env` file:
```env
PORT=5000
DB_URI=your_database_connection
```
Run the app:
```sh
npm run dev
```
---
## 💡 Usage
1. Enter a career goal
2. System processes input
3. Generates roadmap + resources
4. Track progress and add notes
---
## 🧪 Testing
* Unit Tests:
* Input parsing
* Roadmap generation
* Resource recommendation
* Integration Tests:
* API endpoints
Run tests:
```sh
npm test
```
---
## 🔄 DevOps Pipeline
This project implements a full **7-stage CI/CD pipeline**:
1. **Build** – Compile and package application
2. **Test** – Run automated tests
3. **Code Quality** – SonarQube analysis
4. **Security** – Vulnerability scanning
5. **Deploy** – Staging deployment
6. **Release** – Production promotion
7. **Monitoring** – Performance tracking
---
## 🗺️ Roadmap (Features)
* [ ] Career input parsing
* [ ] Dynamic roadmap generation
* [ ] Company-aware recommendations
* [ ] Resource engine
* [ ] Notes & progress tracking
* [ ] Authentication system
* [ ] Adaptive roadmap (AI refinement)
* [ ] Gamification
---
## 🤝 Contributing
1. Fork the Project
2. Create a branch (`feature/your-amazing-feature`)
3. Commit changes
4. Push and open PR
---
## 📄 License
Distributed under the Apache 2.0 License.
---
## 📬 Contact
Chi Vi Han – [hanchivi39@gmail.com](mailto:hanchivi39@gmail.com)
GitHub: https://github.com/Stewie-pixel/mirabile
---
[contributors-shield]: https://img.shields.io/github/contributors/Stewie-pixel/mirabile.svg?style=for-the-badge
[contributors-url]: https://github.com/Stewie-pixel/mirabile/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/Stewie-pixel/mirabile.svg?style=for-the-badge
[forks-url]: https://github.com/Stewie-pixel/mirabile/network/members
[stars-shield]: https://img.shields.io/github/stars/Stewie-pixel/mirabile.svg?style=for-the-badge
[stars-url]: https://github.com/Stewie-pixel/mirabile/stargazers
[issues-shield]: https://img.shields.io/github/issues/Stewie-pixel/mirabile.svg?style=for-the-badge
[issues-url]: https://github.com/Stewie-pixel/mirabile/issues
[license-shield]: https://img.shields.io/github/license/Stewie-pixel/mirabile.svg?style=for-the-badge
[license-url]: https://github.com/Stewie-pixel/mirabile/blob/main/LICENSE
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin
[linkedin-url]: https://linkedin.com/in/chi-vi-han-384612311