{"id":51285295,"url":"https://github.com/sayandedotcom/armoriq","last_synced_at":"2026-06-30T05:01:49.567Z","repository":{"id":368239536,"uuid":"1284103623","full_name":"sayandedotcom/armoriq","owner":"sayandedotcom","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-29T16:04:00.000Z","size":464,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-29T18:06:21.989Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://armoriq-web.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sayandedotcom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-29T14:26:28.000Z","updated_at":"2026-06-29T16:04:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sayandedotcom/armoriq","commit_stats":null,"previous_names":["sayandedotcom/armoriq"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sayandedotcom/armoriq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayandedotcom%2Farmoriq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayandedotcom%2Farmoriq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayandedotcom%2Farmoriq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayandedotcom%2Farmoriq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sayandedotcom","download_url":"https://codeload.github.com/sayandedotcom/armoriq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayandedotcom%2Farmoriq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34952850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-30T05:01:47.342Z","updated_at":"2026-06-30T05:01:49.544Z","avatar_url":"https://github.com/sayandedotcom.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ArmorIQ\n\nAI Agent Security Platform with MCP (Model Context Protocol) Support. ArmorIQ provides a policy layer that sits between an LLM and its tools, deciding what is and isn't allowed.\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                      ArmorIQ Platform                        │\n├─────────────────────────────────────────────────────────────┤\n│  ┌─────────────┐    ┌─────────────────┐    ┌──────────────┐  │\n│  │    Web      │◄──►│     Agent       │◄──►│   MCP Bank   │  │\n│  │  Dashboard  │    │   (FastAPI)     │    │  (MCP Server)│  │\n│  │  (Next.js)  │    │                 │    │              │  │\n│  │   :3000     │    │    :8000        │    │   stdio      │  │\n│  └─────────────┘    └─────────────────┘    └──────────────┘  │\n│         ▲                   ▲                                │\n│         │                   │                                │\n│         └───────── WebSocket ────────────────┘               │\n│                    (Real-time updates)                        │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## Features\n\n- **Policy Engine**: Create guardrail rules (block tools, require approval, input validation, token budgets)\n- **Real-time Enforcement**: Rules take effect immediately via WebSocket\n- **MCP Integration**: Connect to MCP servers with live tool discovery\n- **Approval Workflow**: Human-in-the-loop for sensitive operations\n- **Activity Logging**: Full audit trail of agent decisions\n\n## Prerequisites\n\n- Node.js \u003e= 18\n- pnpm \u003e= 9\n- Python \u003e= 3.11\n- Gemini API key (or another LLM provider)\n\n## Quick Start\n\n### 1. Install Dependencies\n\n```bash\npnpm install\n```\n\n### 2. Configure Environment\n\nCreate `.env` in `apps/agent/`:\n\n```env\nGEMINI_API_KEY=your_gemini_api_key_here\nTAVILY_API_KEY=your_tavily_api_key_here  # optional\nDATABASE_URL=sqlite:///./armoriq.db\n```\n\n### 3. Start Development Servers\n\n```bash\npnpm dev\n```\n\nThis starts all services:\n- **Web Dashboard**: http://localhost:3000\n- **Agent API**: http://localhost:8000\n- **MCP Bank**: stdio connection\n\n## Docker Deployment\n\n```bash\n# Set environment variables\nexport GEMINI_API_KEY=your_key_here\nexport TAVILY_API_KEY=your_key_here\n\n# Start all services\ndocker-compose up\n```\n\n## Development\n\n### Running Services Individually\n\n```bash\n# Terminal 1 - Agent backend\ncd apps/agent \u0026\u0026 PYTHONPATH=./src uv run uvicorn src.main:app --port 8000 --reload\n\n# Terminal 2 - MCP Bank (custom MCP server)\ncd apps/mcp-bank \u0026\u0026 uv run python -m mcp_bank\n\n# Terminal 3 - Web dashboard\ncd apps/web \u0026\u0026 pnpm dev\n```\n\n### Running Tests\n\n```bash\n# Agent tests\ncd apps/agent \u0026\u0026 uv run pytest\n```\n\n## Project Structure\n\n```\narmoriq/\n├── apps/\n│   ├── agent/           # FastAPI agent backend\n│   │   ├── src/\n│   │   │   ├── agent/   # LLM and tool execution\n│   │   │   ├── policy/  # Policy engine\n│   │   │   └── transport/ # MCP transport manager\n│   │   └── servers.json # MCP server configuration\n│   ├── mcp-bank/        # Custom MCP server\n│   │   └── mcp_bank/   # MCP tools implementation\n│   └── web/             # Next.js dashboard\n│       ├── app/         # App router pages\n│       └── src/         # React components\n└── packages/\n    └── shared-types/    # Shared TypeScript types\n```\n\n## MCP Servers\n\n### Custom MCP Bank\n\nThe custom MCP server exposes tools for:\n- CRUD operations on a mini database\n- File management operations\n\n### Remote MCP Servers\n\nConfigure additional MCP servers in `apps/agent/servers.json`:\n\n```json\n{\n  \"name\": \"context7\",\n  \"transport\": \"sse\",\n  \"url\": \"https://api.context7.io/mcp\"\n}\n```\n\n## Policy Rule Types\n\n| Type | Description |\n|------|-------------|\n| `block_tool` | Permanently block a tool |\n| `require_approval` | Block until human approves |\n| `input_validation` | Validate tool arguments |\n| `token_budget` | Limit token usage |\n| `prompt_injection_guard` | Detect prompt injection |\n\n## API Endpoints\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| GET | `/rules` | List all rules |\n| POST | `/rules` | Create rule |\n| PUT | `/rules/{id}` | Update rule |\n| DELETE | `/rules/{id}` | Delete rule |\n| GET | `/approvals` | List pending approvals |\n| POST | `/approvals` | Approve/reject |\n| GET | `/logs` | Activity logs |\n| POST | `/chat` | Send message to agent |\n| WS | `/ws` | WebSocket for real-time updates |\n\n## Tech Stack\n\n- **Agent**: FastAPI, Python, Google Gemini\n- **Dashboard**: Next.js 14, TypeScript, Tailwind CSS, Radix UI\n- **Database**: SQLite (file-based, no setup required)\n- **Protocol**: Model Context Protocol (MCP)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsayandedotcom%2Farmoriq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsayandedotcom%2Farmoriq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsayandedotcom%2Farmoriq/lists"}