diff --git a/README.md b/README.md index 0604b1c..5a23e3d 100644 --- a/README.md +++ b/README.md @@ -8,10 +8,13 @@ These projects are designed for developers looking to grow into "Problem Solver ### Dev Tooling - **[Automated Code-Review-Pipeline](./ideas/dev-tooling/code-review.md)** - **[Repo Documentation & Change Summarizer](./ideas/dev-tooling/repo-summarizer.md)** +- **[Coding Assistant (Gitea Integration)](./ideas/dev-tooling/coding-assistant.md)** ### Infrastructure & Ops - **[Observability-as-a-Service](./ideas/infrastructure-ops/observability.md)** - **[Serverless Micro-Stack Manager](./ideas/infrastructure-ops/micro-stack.md)** +- **[Manage AWS Infrastructure](./ideas/infrastructure-ops/manage-aws.md)** +- **[VPS Management Agent](./ideas/infrastructure-ops/vps-management.md)** ### AI & Knowledge - **[RAG Knowledge Hub](./ideas/ai-knowledge/rag-hub.md)** @@ -20,3 +23,6 @@ These projects are designed for developers looking to grow into "Problem Solver - **[IoT Webhook Bridge](./ideas/personal-automation/home-bridge.md)** - **[Personal Data Aggregator](./ideas/personal-automation/data-aggregator.md)** - **[AI-Driven Habit Tracker & Nudger](./ideas/personal-automation/habit-tracker.md)** +- **[Personal AI Website](./ideas/personal-automation/personal-ai-website.md)** +- **[Homeassistant Agent Integration](./ideas/personal-automation/homeassistant-agent.md)** +- **[Email Communications Agent](./ideas/personal-automation/email-comms.md)** diff --git a/ideas/dev-tooling/coding-assistant.md b/ideas/dev-tooling/coding-assistant.md new file mode 100644 index 0000000..fd6030f --- /dev/null +++ b/ideas/dev-tooling/coding-assistant.md @@ -0,0 +1,18 @@ +# Coding Assistant Agent +An agent that takes assigned tasks from Gitea and implements them within the repository. + +## Overview +A tightly integrated coding companion that interfaces with [assign-me-openclaw](https://gitea.reversed.dev/space/assign-me-openclaw). This project uses the **SHSF (Serverless High-Speed Functions)** runner to handle Gitea webhooks and notify an AI agent via the **OpenClaw API** when it is assigned to an issue or pull request. + +## Features +- **Gitea Webhook Integration**: Uses `assign-me-openclaw` to listen for `assigned` and `unassigned` events from Gitea. +- **Stateful Assignment Tracking**: Employs a database (via SHSF's `_db_com.py`) to track assignees across events, ensuring the agent is correctly notified even when payload data is sparse. +- **OpenClaw Notification**: Automatically sends formatted Markdown notifications to the OpenClaw API when the configured `AGENT_USERNAME` is assigned. +- **SHSF Deployment**: Designed to run as a serverless function, making it lightweight and highly reactive. +- **Automated Workflow**: Once notified, the agent can be programmed to clone the repository, create a branch, and implement changes based on the Gitea issue description. +- **Task Assignment Logic**: Identifies specific triggers (like labels or comments) to initiate coding tasks. + +## Technical Details +- **Environment Driven**: Configurable via `OPENCLAW_URL`, `OPENCLAW_TOKEN`, and `AGENT_USERNAME`. +- **Primary Logic**: Driven by `main.py`, which processes incoming POST requests and filters relevant Gitea events. +- **Integration Point**: Works seamlessly with [SHSF](https://github.com/Space-Banane/shsf) for deployment and database management. diff --git a/ideas/infrastructure-ops/manage-aws.md b/ideas/infrastructure-ops/manage-aws.md new file mode 100644 index 0000000..619503f --- /dev/null +++ b/ideas/infrastructure-ops/manage-aws.md @@ -0,0 +1,11 @@ +# Manage AWS Infrastructure +Agent manages AWS EC2 instances and deploys stuff when needed. + +## Overview +A cloud infrastructure companion that provides an AI wrapper around AWS services, making complex cloud platform management as easy as a conversation. + +## Features +- **Instance Life-cycle Management**: Provision, start, stop, and terminate EC2 instances. +- **Automated Deployment Pipeline**: Agent triggers CI/CD workflows and verifies deployment health. +- **Cost Optimization**: Recommends instance types or shuts down unused infrastructure. +- **Security Monitoring**: Scans for overly permissive Security Groups or unpatched resources. diff --git a/ideas/infrastructure-ops/vps-management.md b/ideas/infrastructure-ops/vps-management.md new file mode 100644 index 0000000..9e4bbae --- /dev/null +++ b/ideas/infrastructure-ops/vps-management.md @@ -0,0 +1,11 @@ +# VPS Management Agent +An agent that manages your Virtual Private Servers (VPS) across different providers. + +## Overview +A tool that allows an agent to manage VPS instances (e.g., DigitalOcean, Linode, Vultr) via SSH and API. It handles server hardening, software updates, and container orchestration. + +## Features +- **Server Hardening**: Automatically configures firewalls, SSH keys, and fail2ban. +- **Automated Updates**: Monitors and applies security patches to the operating system. +- **Docker Orchestration**: Deploys and manages Docker containers across one or more VPS instances. +- **Health Monitoring**: Checks server resource usage and restarts services if they go down. diff --git a/ideas/personal-automation/email-comms.md b/ideas/personal-automation/email-comms.md new file mode 100644 index 0000000..a5a932b --- /dev/null +++ b/ideas/personal-automation/email-comms.md @@ -0,0 +1,11 @@ +# Email Communications Agent +Allow people to talk to your agent via emails. + +## Overview +A bridge between an email inbox and an AI agent, allowing users—or visitors—to interact with the agent as if it were a digital assistant or a direct proxy for the user. + +## Features +- **Inbound Processing**: Agent reads, summarizes, and classifies incoming emails. +- **Drafting and Replying**: Agent can reply to common queries or draft responses for user review. +- **Contextual Knowledge**: Accesses user's files and documents to answer questions via email. +- **Filtering and Routing**: Automatically handles spam or routes important notifications. diff --git a/ideas/personal-automation/homeassistant-agent.md b/ideas/personal-automation/homeassistant-agent.md new file mode 100644 index 0000000..313cf7e --- /dev/null +++ b/ideas/personal-automation/homeassistant-agent.md @@ -0,0 +1,11 @@ +# Homeassistant Agent Integration +Have your agent control things around your house and trigger the agent when something doesn't seem right. + +## Overview +Deep integration between an AI agent and Home Assistant (or other IoT platforms). The agent acts as a smart "home manager" that goes beyond simple automation by understanding context and anomalies. + +## Features +- **Proactive Interventions**: Agent notices if a door is left open or an appliance is running unusually and asks for instructions. +- **Natural Language Control**: Control complex scenes or multiple devices through conversational commands. +- **Anomaly Detection**: Uses historical data to identify when domestic patterns are broken. +- **Preference Learning**: Agent adjusts climate and lighting based on user behavior over time. diff --git a/ideas/personal-automation/personal-ai-website.md b/ideas/personal-automation/personal-ai-website.md new file mode 100644 index 0000000..45f54c9 --- /dev/null +++ b/ideas/personal-automation/personal-ai-website.md @@ -0,0 +1,11 @@ +# Personal AI Website +An website managed, written, and deployed by your agent. + +## Overview +A dynamic website where the content, layout, and deployment are handled by an autonomous agent. The user provides high-level goals or topics, and the agent generates the pages, manages the site structure, and handles the CI/CD pipeline. + +## Features +- **Autonomous Content Generation**: Agent writes blog posts, documentation, or project updates. +- **Dynamic Layout Management**: Agent adjusts the UI/UX based on content type or user feedback. +- **Automated Deployment**: Integrated CI/CD that the agent triggers after updates. +- **Self-Healing**: Agent monitors site health and fixes broken links or deployment issues.