Álvaro Valenzuela Valdes commited on
Commit ·
6a5df4e
1
Parent(s): 899401b
docs: Update README with professional hackathon description and AMD integration
Browse files
README.md
CHANGED
|
@@ -1,38 +1,58 @@
|
|
| 1 |
-
# AndesOps AI
|
| 2 |
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
| 4 |
|
| 5 |
-
|
| 6 |
|
| 7 |
-
|
| 8 |
|
| 9 |
-
##
|
|
|
|
| 10 |
|
| 11 |
-
|
|
|
|
| 12 |
|
| 13 |
-
-
|
| 14 |
-
-
|
| 15 |
-
-
|
| 16 |
-
-
|
| 17 |
|
| 18 |
-
|
| 19 |
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
- Datos: JSON mock inicial con opción Mercado Público API
|
| 23 |
-
- Capa AI: abstracción de proveedor con fallback determinista
|
| 24 |
|
| 25 |
-
|
|
|
|
|
|
|
|
|
|
| 26 |
|
| 27 |
-
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 31 |
|
| 32 |
-
## Setup
|
| 33 |
|
| 34 |
-
###
|
|
|
|
|
|
|
|
|
|
| 35 |
|
|
|
|
| 36 |
```powershell
|
| 37 |
cd backend
|
| 38 |
python -m venv .venv
|
|
@@ -41,39 +61,24 @@ pip install -r requirements.txt
|
|
| 41 |
uvicorn app.main:app --reload --port 8000
|
| 42 |
```
|
| 43 |
|
| 44 |
-
### Frontend
|
| 45 |
-
|
| 46 |
```powershell
|
| 47 |
cd frontend
|
| 48 |
npm install
|
| 49 |
npm run dev
|
| 50 |
```
|
| 51 |
|
| 52 |
-
###
|
| 53 |
-
|
| 54 |
-
|
| 55 |
-
|
| 56 |
-
- `MERCADO_PUBLICO_TICKET`: ticket de Mercado Público si está disponible.
|
| 57 |
-
- `GEMINI_API_KEY`: clave de Gemini para análisis con LLM.
|
| 58 |
-
- `NEXT_PUBLIC_API_BASE`: URL base del backend (por defecto `http://localhost:8000`).
|
| 59 |
-
|
| 60 |
-
## Endpoints principales
|
| 61 |
-
|
| 62 |
-
- `GET /health`
|
| 63 |
-
- `GET /api/tenders?keyword=software`
|
| 64 |
-
- `GET /api/tenders/{code}`
|
| 65 |
-
- `POST /api/company-profile`
|
| 66 |
-
- `POST /api/analyze`
|
| 67 |
-
|
| 68 |
-
## Hackathon submission notes
|
| 69 |
-
|
| 70 |
-
Este MVP se centra en una experiencia demoable y enterprise-ready con:
|
| 71 |
|
| 72 |
-
-
|
| 73 |
-
- Flujo completo de búsqueda, selección, análisis y propuesta
|
| 74 |
-
- Fallback a datos mock para demostrar sin dependencias externas
|
| 75 |
-
- Estructura preparada para añadir soporte real de Mercado Público y Gemini
|
| 76 |
|
| 77 |
-
##
|
|
|
|
|
|
|
|
|
|
| 78 |
|
| 79 |
-
|
|
|
|
|
|
| 1 |
+
# AndesOps AI: Agentic Tender Intelligence
|
| 2 |
|
| 3 |
+
[](https://www.amd.com/en/developer/resources/ai-developer.html)
|
| 4 |
+
[](https://rocm.docs.amd.com/)
|
| 5 |
+
[](https://nextjs.org/)
|
| 6 |
+
[](https://fastapi.tiangolo.com/)
|
| 7 |
|
| 8 |
+
**AndesOps AI** is a state-of-the-art business intelligence platform designed to transform the complex landscape of public procurement in Chile (Mercado Público) into actionable strategic advantages. Built for the **AMD Developer Hackathon**, it leverages a sophisticated **Agentic Multi-Agent System** to analyze technical and administrative bases with unprecedented speed and precision.
|
| 9 |
|
| 10 |
+
---
|
| 11 |
|
| 12 |
+
## 🚀 The Challenge
|
| 13 |
+
Public bidding processes are notoriously document-heavy, requiring legal, technical, and strategic expertise to evaluate a single opportunity. Companies often miss deadlines or overlook critical risks buried in 100+ page PDFs.
|
| 14 |
|
| 15 |
+
## 🧠 The Agentic Solution: "The Virtual Board of Experts"
|
| 16 |
+
AndesOps AI moves beyond simple chatbots. It deploys a **coordinated panel of AI agents** that work in parallel to evaluate every tender:
|
| 17 |
|
| 18 |
+
- ⚖️ **Legal & Compliance Agent**: Scans for administrative hurdles, critical deadlines, and compliance gaps.
|
| 19 |
+
- 🏗️ **Technical Architect Agent**: Maps tender requirements to the company’s specific tech stack and experience.
|
| 20 |
+
- 📊 **Strategy & ROI Agent**: Analyzes competition, calculates potential ROI, and defines a "Winning Strategy".
|
| 21 |
+
- 🧠 **The Orchestrator**: Consolidates agent reports into a final **Strategic Fit Score** and an executive summary.
|
| 22 |
|
| 23 |
+
---
|
| 24 |
|
| 25 |
+
## 🛠️ Architecture & AMD Integration
|
| 26 |
+
AndesOps AI is engineered to scale using high-performance compute:
|
|
|
|
|
|
|
| 27 |
|
| 28 |
+
- **Hardware Acceleration**: Optimized to run on **AMD Instinct™ MI300X GPUs** via the **AMD Developer Cloud**.
|
| 29 |
+
- **Software Stack**: Built on **ROCm™** for high-throughput inference, allowing simultaneous processing of multiple massive tender documents without bottlenecks.
|
| 30 |
+
- **Backend**: **FastAPI** with asynchronous task execution for parallel agent processing.
|
| 31 |
+
- **Frontend**: **Next.js 14** with a premium, enterprise-ready UI/UX.
|
| 32 |
|
| 33 |
+
### **System Workflow**
|
| 34 |
+
```mermaid
|
| 35 |
+
graph TD
|
| 36 |
+
A[Mercado Público API / Sync] --> B[(SQL Database)]
|
| 37 |
+
B --> C[Tender Dashboard]
|
| 38 |
+
C --> D{Agentic Analysis Engine}
|
| 39 |
+
D --> E[Legal Agent]
|
| 40 |
+
D --> F[Technical Agent]
|
| 41 |
+
D --> G[Strategy Agent]
|
| 42 |
+
E & F & G --> H[Orchestrator]
|
| 43 |
+
H --> I[Strategic Report & Proposal]
|
| 44 |
+
```
|
| 45 |
+
|
| 46 |
+
---
|
| 47 |
|
| 48 |
+
## 💻 Setup & Installation
|
| 49 |
|
| 50 |
+
### **Prerequisites**
|
| 51 |
+
- Python 3.10+
|
| 52 |
+
- Node.js 18+
|
| 53 |
+
- AMD ROCm (Optional for local acceleration)
|
| 54 |
|
| 55 |
+
### **Backend Setup**
|
| 56 |
```powershell
|
| 57 |
cd backend
|
| 58 |
python -m venv .venv
|
|
|
|
| 61 |
uvicorn app.main:app --reload --port 8000
|
| 62 |
```
|
| 63 |
|
| 64 |
+
### **Frontend Setup**
|
|
|
|
| 65 |
```powershell
|
| 66 |
cd frontend
|
| 67 |
npm install
|
| 68 |
npm run dev
|
| 69 |
```
|
| 70 |
|
| 71 |
+
### **Environment Variables**
|
| 72 |
+
Copy `.env.example` to `.env` and configure:
|
| 73 |
+
- `GEMINI_API_KEY`: For LLM orchestration (or your AMD local endpoint).
|
| 74 |
+
- `MERCADO_PUBLICO_TICKET`: For real-time tender syncing.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 75 |
|
| 76 |
+
---
|
|
|
|
|
|
|
|
|
|
| 77 |
|
| 78 |
+
## 📈 Business Value
|
| 79 |
+
- **Efficiency**: Reduce manual analysis time by over 90%.
|
| 80 |
+
- **Risk Mitigation**: Early detection of legal traps and technical gaps.
|
| 81 |
+
- **Competitiveness**: Generate high-quality proposal drafts aligned with specific tender scoring criteria.
|
| 82 |
|
| 83 |
+
## 📄 License
|
| 84 |
+
MIT License - Developed for the **AMD Developer Hackathon 2026** with ❤️ by the AndesOps Team.
|