Kabalikat Agent ("The Ally")

An autonomous personal agent providing total life management: Academic, Work, Organizations, and Personal well-being.

💖 Support the Project

If this project helped you, please consider buying me a coffee!

Kabalikat (Tagalog for "Ally") is a hybrid AI agent built with React, Capacitor, and Generative AI. It is designed to act as a proactive "Background Sentry" that monitors your life streams (Email, Calendar) and a "Companion" that you can talk to.

It features Hardware-Level Alerts (Flashlight Strobe, Screen Wake, Native Alarm) for critical deadlines and conflicts, ensuring you never miss what matters even if your phone is silent.

Features

• Background Sentry Mode: Autonomously analyzes emails and schedule conflicts.
• Tier 1 Hardware Alerts: Triggers real physical alarms (Flashlight Strobe + Siren + Screen Wake) for critical events.
• Total Recall Memory: Remembers your preferences, routines, and identity using the TOON memory format.
• Vision Sentry: Uses AI Vision to scan and extract schedules from photos of documents or whiteboards.
• Intelligent Calendar: Auto-schedules events and detects conflicts between Work, School, and Org commitments.
• Plugin Architecture: Built on Capacitor to access Native Android features (AlarmManager, Flashlight, Notifications).

Tech Stack

• Framework: React 19 + Vite
• Native Runtime: Capacitor 8 (Android)
• AI Core: Pluggable AI Architecture (Supports Azure Open AI, Google Gemini etc.)
• Styling: TailwindCSS
• Icons: Lucide React
• Storage: LocalStorage + FileSystem (Hybrid)

Prerequisites

• Node.js (v18 or higher)
• Android Studio (for building the APK)
• An AI Provider API Key (e.g., Azure Open AI, Google Gemini)

Installation

Download APK (Android)

You can download the latest pre-built APK from the Releases Page of this repository.

Build from Source

1. Clone the repository

   git clone https://github.com/aint-vscp/kabalikat-agent.git
   cd kabalikat-agent

2. Install Dependencies

   npm install

3. Sync Native Project

   npm run build
   npx cap sync android

Running on Device

To test the Hardware Alerts and Native Alarm features, you must run this on a physical Android device or Emulator.

1. Open in Android Studio

   npx cap open android

2. Wait for Gradle to sync, then press the Run button.

(Note: Web-only features work directly with npm run dev, but native alarms will fallback to console logs.)

OAuth Configuration (For Google Sign-In)

If you are using the Google Classroom or Gmail integration features, you need to configure your Google Cloud Console:

1. Create an OAuth 2.0 Client ID (Web Application).
2. Add https://localhost to Authorized Redirect URIs.
3. Add the Client ID and Secret in the App Settings inside the application.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.