perception-with-intent

# Perception

> **AI-powered news intelligence that cuts through the noise**

Stop manually checking 50 news sources every morning. Perception monitors everything, filters what matters using 8 specialized Vertex AI agents, and delivers executive-level insights to your dashboard.

**Live Demo:** [perception-with-intent.web.app](https://perception-with-intent.web.app)

---

## What Is This?

Perception is a production example of an AI agent system built on Google Cloud. It demonstrates how to architect, deploy, and operate multi-agent systems for real-world intelligence gathering.

This repository contains:
- 8 specialized AI agents coordinated via A2A Protocol
- Source-agnostic news ingestion (RSS, APIs, custom connectors)
- Real-time executive dashboard (Firebase + Firestore)
- Production deployment infrastructure (Terraform + GitHub Actions)
- Complete CI/CD pipeline with Workload Identity Federation

**Built by [Intent Solutions IO](https://intentsolutions.io)** — We design and deploy custom AI agent systems for enterprise intelligence.

---

## Key Features

### Source Agnostic
Monitor any topic from any source. RSS feeds, proprietary APIs, or custom connectors. No vendor lock-in.

### AI-Powered Analysis
Gemini 2.0 Flash generates summaries, extracts insights, and identifies strategic implications automatically.

### Executive Dashboard
Real-time intelligence delivered through a clean, professional interface. Filter by relevance, topic, or priority.

### Daily Executive Briefs
Automated summaries highlight patterns, emerging trends, and strategic implications across all monitored topics.

### Smart Alerts
Configurable alerts notify you when high-priority signals emerge. Slack, email, or webhook integration.

### Enterprise Security
Built on Google Cloud with Workload Identity Federation, encrypted storage, and comprehensive audit logging.

---

## ⚡ Quick Start

### Prerequisites

```bash
# Required
- Python 3.11+
- Docker Desktop
- Google Cloud account
- Node.j