ph-agent-hub

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #golang #linux #docker #macos #nodejs #java #windows #cli #awesome-list #ios

(★ 9)

PH Agent Hub is a modular AI platform with a Chat UI for users and an Admin UI for managing models, tools, tenants, and users. Powered by a flexible agent backend, it supports multi‑tenant setups, DeepSeek‑compatible workflows, and Docker‑based deployment.

ph-agent-hub 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PH Agent Hub

![PH Agent Hub Banner](https://raw.githubusercontent.com/kainotomo/ph-agent-hub/main/docs/assets/ph-agent-hub-banner.svg)

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://raw.githubusercontent.com/kainotomo/ph-agent-hub/main/LICENSE)
[![GitHub Stars](https://img.shields.io/github/stars/kainotomo/ph-agent-hub?label=stars&logo=github)](https://star-history.com/#kainotomo/ph-agent-hub&Date)
[![Last Commit](https://img.shields.io/github/last-commit/kainotomo/ph-agent-hub)](https://github.com/kainotomo/ph-agent-hub)
[![Issues](https://img.shields.io/github/issues/kainotomo/ph-agent-hub)](https://github.com/kainotomo/ph-agent-hub/issues)
[![Docker Pulls](https://img.shields.io/docker/pulls/phalouvas/ph-agent-hub-backend)](https://hub.docker.com/r/phalouvas/ph-agent-hub-backend)
[![CI](https://github.com/kainotomo/ph-agent-hub/actions/workflows/ci.yml/badge.svg)](https://github.com/kainotomo/ph-agent-hub/actions/workflows/ci.yml)
[![Try the Widget](https://img.shields.io/badge/Try%20the%20Widget-Live-brightgreen)](https://kainotomo.com/ph-agent-hub)
[![Demo Video](https://img.shields.io/badge/📺-Watch%20Demo-red?style=flat-square)](https://youtu.be/iy5mO3nRxH0)

## Screenshots

| Chat UI | Admin UI | Widget Demo |
|---|---|---|
| ![Chat Interface](https://raw.githubusercontent.com/kainotomo/ph-agent-hub/main/docs/assets/chat-ui.jpeg) | ![Admin Panel](https://raw.githubusercontent.com/kainotomo/ph-agent-hub/main/docs/assets/admin-ui.jpeg) | ![Embeddable Widget](https://raw.githubusercontent.com/kainotomo/ph-agent-hub/main/docs/assets/widget-demo.jpeg) |

> **💬 Live embedded widget** — Visit [kainotomo.com/ph-agent-hub](https://kainotomo.com/ph-agent-hub) and click the chat icon in the bottom-right corner to try the embedded widget yourself.

PH Agent Hub is a multi-tenant AI application platform for teams that need both:
- a production chat experience for end users
- an operational admin control plane for models, tools, tenancy, and governance

It is built on FastAPI + React and uses the [Microsoft Agent Framework](https://github.com/microsoft/agent-framework) for agent runtime orchestration.

Live demo: [agent.kainotomo.com/demo](https://agent.kainotomo.com/demo)

## Why This Exists

Most open-source AI chat projects are strong at single-tenant chat UX or developer experimentation. PH Agent Hub is optimized for teams shipping tenant-isolated AI products where operations matter as much as chat quality.

What you get in one system:
- dual UI model: Chat Area + Admin Area in one web app
- tenant isolation at the backend authorization and data layer
- model and tool governance per tenant
- embedded website widget for anonymous or guided external usage
- deployment that stays simple: Docker Compose dev and prod paths

## Run In 3 Commands

```bash
git clone https://github.com/kainotomo/ph-agent-hub.git
cd ph-agent-hub/infrastructure
cp env.example env
```

Then set required env values in env and start:

```bash
docker compose up --build
```

Required env values:

| Variable | Why it is required |
|---|---|
| JWT_SECRET | Signs access and refresh tokens |
| ENCRYPTION_KEY | Encrypts provider API keys at rest |
| ADMIN_EMAIL | Bootstraps initial admin user |
| ADMIN_PASSWORD | Bootstraps initial admin password |
| At least one provider key | Enables model inference (DeepSeek/OpenAI/Anthropic/etc.) |

Endpoints after startup:
- App: [http://localhost](http://localhost)
- phpMyAdmin (dev): [http://localhost:8080](http://localhost:8080)
- MinIO Console (dev): [http://localhost:9001](http://localhost:9001)

Default login on first run: admin@phagent.local / admin (change immediately).

## Run Tests

With Docker Compose running (MariaDB + Redis on localhost), run the backend test suite:

```bash
cd backend
source .venv/bin/activate
DATABASE_URL="mysql+aiomysql://phagent:${MYSQL_PASSWORD}@127.0.0.1:3306/phagent_hub?charset=utf8mb4" \
  REDIS_URL="redis://127.0.0.1:6379/0" \
  JWT_SECRET="test" \
  ENCRYPTION_KEY="$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')" \
  pytest tests/ -m "not e2e"
```

Or from inside the Docker container (no env var setup needed):

```bash
docker compose exec backend pytest /app/tests/ -m "not e2e"
```

A CI pipeline runs on every pull request to `main` — see `.github/workflows/ci.yml`.

### Security & Tenant Isolation Tests

Security-focused tests validate authentication, authorization, tenant isolation, OAuth integrity, and rate limiting:

```bash
# Run security tests only
pytest backend/tests/ -m "security" -v

# Run tenant isolation tests only
pytest backend/tests/ -m "tenant_isolation" -v

# Run both
pytest backend/tests/ -m "security or tenant_isolation" -v
```

See [docs/security-testing.md](docs/security-testing.md) for the full test suite reference.

## Who It Is For

- Teams building tenant-aware AI SaaS or internal multi-business-unit copilots
- Developers who need configurable tools, models, and skills without hard-coding per customer
- Operators who need auditability, usage visibility, and role-based controls

## Differentiators

- Multi-tenant from the core domain model, not bolted on later
- Built-in admin control plane for real operations, not only prompt experimentation
- DeepSeek stabilizer layer (reasoning strip, JSON repair, retry orchestration)
- Embeddable chat widget with anonymous guest flow and demo-mode support
- Microsoft Agent Framework runtime integration for workflow-friendly agent execution

## How It Compares

Technical comparison for first-pass evaluation.

| Capability | PH Agent Hub | Dify | Onyx | Open WebUI | LibreChat |
|---|---|---|---|---|---|
| First-class multi-tenant isolation | Yes | Partial (varies by setup) | Team-oriented, not full tenant governance | Primarily single-instance | Primarily single-instance |
| Unified Chat + Admin product surfaces | Yes | Yes | More knowledge assistant focus | Chat-first | Chat-first |
| Tenant-scoped model + tool governance | Yes | Partial | Partial | Limited by deployment pattern | Limited by deployment pattern |
| Embeddable widget for external websites | Yes | Yes | Not primary focus | Limited | Limited |
| DeepSeek hardening layer (JSON repair/retry) | Yes | No native equivalent | No native equivalent | No native equivalent | No native equivalent |
| Self-host with one Compose stack | Yes | Yes | Yes | Yes | Yes |
| Built on Microsoft Agent Framework runtime | Yes | No | No | No | No |

Notes:
- "Partial" means achievable but usually depends on custom deployment conventions or enterprise configuration.
- Validate against your own requirements and current upstream versions before final adoption decisions.

## Visual Architecture

```mermaid
flowchart TB
    subgraph Frontend[React Frontend]
        Chat[Chat Area<br/>end users]
        Admin[Admin Area<br/>admins and managers]
    end

Chat -->|REST + SSE| API
    Admin -->|REST| API

subgraph Backend[FastAPI + Agent Runtime]
        API[API Layer]
        Auth[Auth + RBAC]
        Agents[MAF Execution]
        Services[Models • Tools • Sessions • Memory]
        API --> Auth
        API --> Agents
        API --> Services
    end

Services --> DB[(MariaDB)]
    Services --> Cache[(Redis)]
    Services --> Obj[(MinIO)]

subgraph TenantBoundary[Tenant Isolation Boundary]
        T1[Tenant A data]
        T2[Tenant B data]
        T3[Tenant N data]
    end

Auth --> TenantBoundary
```

For deeper architecture detail, see [docs/architecture-overview.md](docs/architecture-overview.md).

## Feature Snapshot

### End Users
- Streaming chat responses with SSE
- Model selection from tenant-enabled providers
- Templates, prompts, and skills
- File uploads + RAG search support
- Session branching, feedback, full-text search
- Temporary sessions and finalization flow

### Admins And Managers
- Tenant, user, and role management
- Model and tool registration with encrypted secrets
- Template and skill governance
- Usage analytics and audit logs
- Demo tenant and public try-it-now controls

### Platform
- Multi-tenant authorization and data boundaries
- Docker-native deployment for dev and production
- Extensible tools, model adapters, and agent integrations
- **A2A (Agent-to-Agent) Protocol** — Client: discover and use external A2A agents as tools. Server: expose ph-agent-hub agents to the A2A ecosystem via Agent Card and task execution endpoints.
- Backend services that can be patched and extended safely

## Folder Structure

```text
.
├── backend/          # FastAPI app, agent runtime integration, services, DB models
├── frontend/         # React app for Chat Area and Admin Area
├── docs/             # Architecture, guides, deployment and data model docs
└── infrastructure/   # Docker Compose, environment templates, reverse proxy config
```

## Documentation Map

Start here:
- [docs/README.md](docs/README.md)
- [CHANGELOG.md](CHANGELOG.md) — release history

Role-specific guides:
- [docs/user-guide.md](docs/user-guide.md)
- [docs/admin-guide.md](docs/admin-guide.md)

Engineering references:
- [docs/architecture-overview.md](docs/architecture-overview.md)
- [docs/backend-architecture.md](docs/backend-architecture.md)
- [docs/frontend-architecture.md](docs/frontend-architecture.md)
- [docs/data-model.md](docs/data-model.md)
- [docs/deployment.md](docs/deployment.md)
- [docs/agent-framework-integration.md](docs/agent-framework-integration.md)
- [docs/deepseek-stabilizer.md](docs/deepseek-stabilizer.md)

## 💼 Licensing

- **Free**: MIT license, up to 3 tenants — [get started](https://github.com/kainotomo/ph-agent-hub)
- **Pro**: €299/year, unlimited tenants — [buy license](https://kainotomo.com/ph-agent-hub/pro-license)
- **Cloud Hosted**: €49/month, fully managed — [get hosted](https://kainotomo.com/ph-agent-hub/cloud-hosted)

## 💬 Community

- 🐛 [Report a bug](https://github.com/kainotomo/ph-agent-hub/issues/new)
- 📧 Email: info@kainotomo.com
- 🌐 Website: [kainotomo.com](https://kainotomo.com/ph-agent-hub)

ph-agent-hub

ph-agent-hub 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ph-agent-hub

ph-agent-hub 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README