@haribon

Autonomous agent for the BetterGov.ph platform. Automates tasks like data aggregation, content summarization, and civic information retrieval to power the main citizen portal.

Note

Beta Status: Haribon is currently under active development and not yet deployed in production. Features, architecture, and documentation are still evolving, and breaking changes may occur. The project will exit beta once the core systems, developer tooling, and documentation are fully stable.

Contributing

We are committed to fostering a safe and inclusive open-source community.
Please review and follow our Code of Conduct when contributing or participating in this project.

Monorepo Setup

Core Packages	Description
client	Web client with chat UI and landing page powered by Agent Chat UI
agentic	Agent runtime for tools, workflows, and LLM logic
api	Backend services including endpoints, webhooks, and integrations
@haribon/db	Database layer with schemas, Pinecone, and MongoDB clients
@haribon/shared	Shared utilities such as encryption, constants, types, and helpers

Prerequisites

• Node.js >= 20.19 or nvm
• Bun latest runtime

Bun Setup

Install Bun by following the official instructions: Bun Installation Guide

Or use the one-line installer:

$ curl -fsSL https://bun.com/install | bash

To check that Bun was installed successfully, open a new terminal window and run:

$ bun -version

Install Dependencies

$ bun install

Setup .env (environment variables)

Copy the example file to .env:

$ cp env.example .env

Development Server

Run the development servers with Turborepo:

$ bun run dev

Run a specific app only:

$ bun run dev:agentic

Running Build

$ bun run build

Security

If you believe you have discovered a security vulnerability in BetterGov Agentic, do not create a public GitHub issue.
Public reports may expose sensitive information before the problem is resolved.

Please read our Security Policy for instructions on responsible disclosure.

License

Haribon Agentic is licensed under GPL-3.0. LICENSE