vilvona 1.0.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Third-party notices for incorporated or adapted code are recorded in
+THIRD_PARTY_NOTICES.md.

package/README.md

@@ -0,0 +1,314 @@
+<div align="center">
+
+<img src="ui/public/logo1.png" alt="Vilvona AI" width="120" />
+
+# Vilvona AI
+
+**Your personal AI that connects everything.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/vilvona?color=orange)](https://www.npmjs.com/package/vilvona)
+[![GitHub Stars](https://img.shields.io/github/stars/vignesh2027/Vilvona-AI?style=social)](https://github.com/vignesh2027/Vilvona-AI)
+[![Claude Fable 5](https://img.shields.io/badge/AI-Claude%20Fable%205-blueviolet)](https://anthropic.com)
+[![Mobile PWA](https://img.shields.io/badge/Mobile-PWA%20Ready-0ea5e9)](#mobile-pwa)
+[![Node 22+](https://img.shields.io/badge/Node-22%2B-brightgreen)](https://nodejs.org)
+[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-red)](https://github.com/sponsors/vignesh2027)
+
+Powered by **Claude Fable 5** — the most capable AI from Anthropic.  
+Works on **desktop, mobile, and tablet**. Supports **Tamil**, **Hindi**, and 21 languages.  
+100% **BYOK** — bring your own API key. Your data never leaves your machine.
+
+[Quick Start](#quick-start) · [Features](#features) · [Docker](#docker) · [Pro Tier](#pro-tier) · [Sponsors](#sponsors)
+
+</div>
+
+---
+
+## What is Vilvona AI?
+
+Vilvona AI is a self-hosted personal AI assistant that connects to all your apps — WhatsApp, Telegram, Slack, Gmail, Discord, Notion, GitHub, and more — from one clean interface. Run it locally or on your server. Zero data sent to third parties. You own everything.
+
+It is built on the foundation of [OpenClaw](https://openclaw.ai) (MIT license) with three key upgrades:
+
+1. **Claude Fable 5** as the default model — the most intelligent AI available today
+2. **Tamil & Hindi UI** — first AI assistant with native support for India's languages
+3. **Mobile PWA** — install on your phone from the browser, no app store needed
+
+---
+
+## Quick Start
+
+```bash
+# Run instantly — no install needed
+npx vilvona
+
+# Or install globally
+npm install -g vilvona
+vilvona
+```
+
+Set your Anthropic API key (get one free at [console.anthropic.com](https://console.anthropic.com)):
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+npx vilvona
+```
+
+Open **http://localhost:4000** in your browser. That's it.
+
+> **Mobile:** Open http://your-ip:4000 on your phone and tap "Add to Home Screen" to install as a PWA app.
+
+---
+
+## Features
+
+### Core
+
+| Feature              | Details                                                                                                         |
+| -------------------- | --------------------------------------------------------------------------------------------------------------- |
+| **Claude Fable 5**   | Default model — 1M context, computer use, best reasoning                                                        |
+| **21 Languages**     | Tamil (தமிழ்), Hindi (हिन्दी), English, Chinese, Japanese, Korean, Arabic, French, German, Spanish, and 12 more |
+| **Mobile PWA**       | Install as an app on iOS and Android directly from your browser                                                 |
+| **BYOK**             | Bring your own Anthropic API key — Vilvona pays nothing, you pay per token directly                             |
+| **Self-hosted**      | Runs entirely on your machine; no cloud, no accounts, no tracking                                               |
+| **All integrations** | 100+ app connections inherited from OpenClaw                                                                    |
+
+### AI Models
+
+```bash
+# Claude Fable 5 (default — most capable)
+export VILVONA_DEFAULT_MODEL=fable
+
+# Claude Opus 4.8 (balanced)
+export VILVONA_DEFAULT_MODEL=opus
+
+# Claude Sonnet 4.6 (fast & affordable)
+export VILVONA_DEFAULT_MODEL=sonnet
+```
+
+Or set in your config file:
+
+```json
+{
+  "defaults": {
+    "model": "anthropic/claude-fable-5"
+  }
+}
+```
+
+### Connected Apps
+
+| Category         | Apps                                                |
+| ---------------- | --------------------------------------------------- |
+| **Messaging**    | WhatsApp, Telegram, iMessage (Mac), Signal, Discord |
+| **Work**         | Slack, Gmail, Notion, GitHub, Linear, Jira          |
+| **Social**       | Instagram DM, Twitter/X                             |
+| **Productivity** | Google Calendar, Google Drive, Dropbox              |
+| **Developer**    | GitHub, GitLab, webhooks, custom MCP servers        |
+
+---
+
+## Installation
+
+### npx (recommended — no install)
+
+```bash
+npx vilvona
+```
+
+### npm global
+
+```bash
+npm install -g vilvona
+vilvona
+```
+
+### Docker
+
+```bash
+docker run \
+  -e ANTHROPIC_API_KEY=sk-ant-... \
+  -p 4000:4000 \
+  ghcr.io/vignesh2027/vilvona-ai:latest
+```
+
+### Build from source
+
+```bash
+git clone https://github.com/vignesh2027/Vilvona-AI.git
+cd Vilvona-AI
+node --version  # Must be 22+
+pnpm install
+pnpm dev
+```
+
+> **Requires Node.js 22+.** If you have nvm: `nvm install 22 && nvm use 22`
+
+---
+
+## Mobile PWA
+
+Vilvona AI works as a full mobile app — no App Store, no Play Store needed.
+
+**On iPhone (Safari):**
+
+1. Open `http://your-machine-ip:4000`
+2. Tap the share icon → **Add to Home Screen**
+3. Vilvona AI is now on your home screen
+
+**On Android (Chrome):**
+
+1. Open `http://your-machine-ip:4000`
+2. Tap the menu → **Install app**
+3. Done
+
+---
+
+## Languages
+
+Vilvona AI is the first AI assistant with built-in Tamil and Hindi UI:
+
+| Language           | Code    | Status  |
+| ------------------ | ------- | ------- |
+| Tamil (தமிழ்)      | `ta`    | Full UI |
+| Hindi (हिन्दी)     | `hi`    | Full UI |
+| English            | `en`    | Full UI |
+| Chinese Simplified | `zh-CN` | Full UI |
+| Japanese           | `ja-JP` | Full UI |
+| Korean             | `ko`    | Full UI |
+| Arabic             | `ar`    | Full UI |
+| French             | `fr`    | Full UI |
+| German             | `de`    | Full UI |
+| Spanish            | `es`    | Full UI |
+| + 11 more          | —       | Full UI |
+
+---
+
+## Pro Tier
+
+Vilvona AI Pro unlocks enterprise and team features.
+
+| Feature                        | Free | Pro |
+| ------------------------------ | ---- | --- |
+| Claude Fable 5                 | ✅   | ✅  |
+| All integrations               | ✅   | ✅  |
+| Tamil & Hindi UI               | ✅   | ✅  |
+| Mobile PWA                     | ✅   | ✅  |
+| Enterprise audit logs          | —    | ✅  |
+| Team config sync               | —    | ✅  |
+| Advanced analytics             | —    | ✅  |
+| Priority Fable 5 routing       | —    | ✅  |
+| Custom AI personas (unlimited) | —    | ✅  |
+| Webhook & Zapier integrations  | —    | ✅  |
+| White-label branding           | —    | ✅  |
+
+**Get Pro — ₹4,100 one-time (~$49):** [vignesh2027.mojo.page/vilvona-ai-pro](https://vignesh2027.mojo.page/vilvona-ai-pro)
+
+```bash
+export VILVONA_PRO_KEY=VLVN-XXXX-XXXX-XXXX-XXXX
+vilvona
+```
+
+---
+
+## Docker
+
+```bash
+# Quick start
+docker run -e ANTHROPIC_API_KEY=sk-ant-... -p 4000:4000 ghcr.io/vignesh2027/vilvona-ai
+
+# With Pro key
+docker run \
+  -e ANTHROPIC_API_KEY=sk-ant-... \
+  -e VILVONA_PRO_KEY=VLVN-XXXX-XXXX-XXXX-XXXX \
+  -p 4000:4000 \
+  ghcr.io/vignesh2027/vilvona-ai
+
+# With persistent data
+docker run \
+  -e ANTHROPIC_API_KEY=sk-ant-... \
+  -v ~/.vilvona:/root/.openclaw \
+  -p 4000:4000 \
+  ghcr.io/vignesh2027/vilvona-ai
+```
+
+---
+
+## Configuration
+
+Vilvona AI stores its config at `~/.openclaw/config.json`:
+
+```json
+{
+  "defaults": {
+    "model": "anthropic/claude-fable-5"
+  },
+  "ui": {
+    "locale": "ta"
+  }
+}
+```
+
+**Environment variables:**
+
+| Variable                | Description                                          |
+| ----------------------- | ---------------------------------------------------- |
+| `ANTHROPIC_API_KEY`     | Your Anthropic API key (required)                    |
+| `VILVONA_DEFAULT_MODEL` | Default model: `fable`, `opus`, `sonnet`             |
+| `VILVONA_PRO_KEY`       | Pro license key (format: `VLVN-XXXX-XXXX-XXXX-XXXX`) |
+| `OPENCLAW_PORT`         | Port to run on (default: `4000`)                     |
+
+---
+
+## Why Vilvona vs OpenClaw?
+
+|                | Vilvona AI                                     | OpenClaw      |
+| -------------- | ---------------------------------------------- | ------------- |
+| Default model  | Claude Fable 5                                 | Varies        |
+| Tamil language | Built-in                                       | Not supported |
+| Hindi language | Built-in                                       | Not supported |
+| Mobile PWA     | Enhanced                                       | Basic         |
+| Pro tier       | Included                                       | None          |
+| Maintained by  | [@vignesh2027](https://github.com/vignesh2027) | OpenClaw team |
+
+---
+
+## Sponsors
+
+Vilvona AI is free and open source. If it saves you time, consider sponsoring:
+
+[![GitHub Sponsors](https://img.shields.io/badge/Sponsor%20on-GitHub-ea4aaa?logo=github)](https://github.com/sponsors/vignesh2027)
+[![Get Pro](https://img.shields.io/badge/Get-Pro%20License-orange)](https://vignesh2027.mojo.page/vilvona-ai-pro)
+
+---
+
+## Reporting Issues
+
+Found a bug? [Open an issue](https://github.com/vignesh2027/Vilvona-AI/issues)
+
+---
+
+## License
+
+[MIT](LICENSE) — free to use, modify, and distribute.
+
+Built on [OpenClaw](https://openclaw.ai) (MIT). All OpenClaw contributors are credited in [UPSTREAM.md](UPSTREAM.md).
+
+---
+
+## Built by
+
+**Vignesh S** — [github.com/vignesh2027](https://github.com/vignesh2027)
+
+CSE student at Takshashila University, Chennai.  
+Building tools that make AI accessible for everyone — especially in Tamil and Hindi.
+
+---
+
+<div align="center">
+
+**If Vilvona AI helped you, please ⭐ star this repo**
+
+[Report Bug](https://github.com/vignesh2027/Vilvona-AI/issues) · [Request Feature](https://github.com/vignesh2027/Vilvona-AI/issues) · [Get Pro](https://vignesh2027.mojo.page/vilvona-ai-pro) · [Sponsor](https://github.com/sponsors/vignesh2027)
+
+</div>

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,37 @@
+# Third-party notices
+
+This file records third-party notices for code or substantial implementation
+portions incorporated into OpenClaw source, beyond normal package-manager
+dependency metadata.
+
+## Pi / pi-mono
+
+Portions of OpenClaw were adapted from Pi / pi-mono, and OpenClaw also depends
+on `@earendil-works/pi-tui` for terminal UI rendering.
+
+- Upstream: https://github.com/earendil-works/pi-mono
+- Package family: `@earendil-works/pi-*`
+- License: MIT
+- Copyright: Copyright (c) 2025 Mario Zechner
+
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/docs/.i18n/README.md

@@ -0,0 +1,81 @@
+# OpenClaw docs i18n assets
+
+This folder stores translation config for the source docs repo.
+
+Generated locale trees and live translation memory now live in the publish repo:
+
+- repo: `openclaw/docs`
+- local checkout: `~/Projects/openclaw-docs`
+
+## Source of truth
+
+- English docs are authored in `openclaw/openclaw`.
+- The source docs tree lives under `docs/`.
+- The source repo no longer keeps committed generated locale trees such as `docs/zh-CN/**`, `docs/zh-TW/**`, `docs/ja-JP/**`, `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, `docs/fr/**`, `docs/ar/**`, `docs/it/**`, `docs/vi/**`, `docs/nl/**`, `docs/fa/**`, `docs/tr/**`, `docs/uk/**`, `docs/id/**`, `docs/pl/**`, or `docs/th/**`.
+
+## End-to-end flow
+
+1. Edit English docs in `openclaw/openclaw`.
+2. Push to `main`.
+3. `openclaw/openclaw/.github/workflows/docs-sync-publish.yml` mirrors the docs tree into `openclaw/docs`.
+4. The sync script rewrites the publish `docs/docs.json` so the generated locale picker blocks exist there even though they are no longer committed in the source repo.
+5. `openclaw/docs/.github/workflows/translate-all.yml` waits for `main` to settle, translates only stale or missing locale pages, and uploads per-locale artifacts.
+6. The publish repo finalizer applies successful locale artifacts and pushes one aggregate `chore(i18n): refresh translations` commit.
+7. A weekly `full` run reconciles every locale/page path so flaky model failures are retried without making hot docs commits wait.
+
+## Why the split exists
+
+- Keep generated locale output out of the main product repo.
+- Keep Mintlify on a single published docs tree.
+- Preserve the built-in language switcher for Mintlify-supported generated locales by letting the publish repo own generated locale trees.
+- Keep generated Thai (`th`) and Persian (`fa`) docs plus translation memory even though Mintlify does not currently accept those codes in `navigation.languages`. Their absence from the built-in docs language picker is a host limitation, not a failed translation run.
+
+## Locale visibility
+
+- Control UI supports `en`, `zh-CN`, `zh-TW`, `pt-BR`, `de`, `es`, `ja-JP`, `ko`, `fr`, `ar`, `it`, `tr`, `uk`, `id`, `pl`, `th`, `vi`, `nl`, and `fa`.
+- Docs translation workflows generate the same non-English locale set in `openclaw/docs`.
+- The Mintlify docs language picker can expose only the locales accepted by Mintlify `navigation.languages`; today that includes Vietnamese (`vi`) and Dutch (`nl`), but not Thai (`th`) or Persian (`fa`).
+- Do not treat missing `th` or `fa` entries in generated `docs/docs.json` as a pipeline failure. Verify their generated folders in `openclaw/docs` instead.
+
+## Files in this folder
+
+- `glossary.<lang>.json` — preferred term mappings used as prompt guidance.
+- `zh-Hans-navigation.json` — curated zh-Hans Mintlify locale navigation reinserted into the publish repo during sync.
+- `ar-navigation.json`, `de-navigation.json`, `es-navigation.json`, `fr-navigation.json`, `id-navigation.json`, `it-navigation.json`, `ja-navigation.json`, `ko-navigation.json`, `pl-navigation.json`, `pt-BR-navigation.json`, and `tr-navigation.json` — starter locale metadata kept alongside the source repo, but the publish sync now clones the full English nav tree for clone-en locales so translated pages are visible in Mintlify without hand-maintaining per-locale nav JSON.
+- `<lang>.tm.jsonl` — translation memory keyed by workflow + model + text hash.
+
+In this repo, generated locale TM files such as `docs/.i18n/zh-CN.tm.jsonl`, `docs/.i18n/zh-TW.tm.jsonl`, `docs/.i18n/ja-JP.tm.jsonl`, `docs/.i18n/es.tm.jsonl`, `docs/.i18n/pt-BR.tm.jsonl`, `docs/.i18n/ko.tm.jsonl`, `docs/.i18n/de.tm.jsonl`, `docs/.i18n/fr.tm.jsonl`, `docs/.i18n/ar.tm.jsonl`, `docs/.i18n/it.tm.jsonl`, `docs/.i18n/vi.tm.jsonl`, `docs/.i18n/nl.tm.jsonl`, `docs/.i18n/fa.tm.jsonl`, `docs/.i18n/tr.tm.jsonl`, `docs/.i18n/uk.tm.jsonl`, `docs/.i18n/id.tm.jsonl`, `docs/.i18n/pl.tm.jsonl`, and `docs/.i18n/th.tm.jsonl` are intentionally no longer committed.
+
+## Glossary format
+
+`glossary.<lang>.json` is an array of entries:
+
+```json
+{
+  "source": "troubleshooting",
+  "target": "故障排除"
+}
+```
+
+Fields:
+
+- `source`: English (or source) phrase to prefer.
+- `target`: preferred translation output.
+
+## Translation mechanics
+
+- `scripts/docs-i18n` still owns translation generation.
+- Doc mode writes `x-i18n.source_hash` into each translated page.
+- The publish workflow precomputes a pending file list by comparing the current English source hash to the stored locale `x-i18n.source_hash`.
+- If the pending count is `0`, the expensive translation step is skipped entirely.
+- If there are pending files, the workflow translates only those files.
+- Locale workers retry transient model-format failures, but unchanged files stay skipped because the same hash check runs on each retry.
+- Locale workers upload artifacts; the publish repo finalizer commits all successful locale outputs together.
+- Published GitHub releases dispatch one aggregate translation refresh so release docs can catch up without waiting for the weekly reconciliation.
+
+## Operational notes
+
+- Sync metadata is written to `.openclaw-sync/source.json` in the publish repo.
+- Source repo secret: `OPENCLAW_DOCS_SYNC_TOKEN`
+- Publish repo secret: `OPENCLAW_DOCS_I18N_OPENAI_API_KEY`
+- If locale output looks stale, check the `Translate All` workflow in `openclaw/docs` first.

package/docs/.i18n/ar-navigation.json

@@ -0,0 +1,18 @@
+{
+  "language": "ar",
+  "tabs": [
+    {
+      "tab": "ابدأ",
+      "groups": [
+        {
+          "group": "نظرة عامة",
+          "pages": ["ar/index"]
+        },
+        {
+          "group": "الخطوات الأولى",
+          "pages": ["ar/start/getting-started", "ar/start/wizard"]
+        }
+      ]
+    }
+  ]
+}

package/docs/.i18n/de-navigation.json

@@ -0,0 +1,18 @@
+{
+  "language": "de",
+  "tabs": [
+    {
+      "tab": "Loslegen",
+      "groups": [
+        {
+          "group": "Überblick",
+          "pages": ["de/index"]
+        },
+        {
+          "group": "Erste Schritte",
+          "pages": ["de/start/getting-started", "de/start/wizard"]
+        }
+      ]
+    }
+  ]
+}

package/docs/.i18n/es-navigation.json

@@ -0,0 +1,18 @@
+{
+  "language": "es",
+  "tabs": [
+    {
+      "tab": "Comenzar",
+      "groups": [
+        {
+          "group": "Resumen",
+          "pages": ["es/index"]
+        },
+        {
+          "group": "Primeros pasos",
+          "pages": ["es/start/getting-started", "es/start/wizard"]
+        }
+      ]
+    }
+  ]
+}

package/docs/.i18n/fr-navigation.json

@@ -0,0 +1,18 @@
+{
+  "language": "fr",
+  "tabs": [
+    {
+      "tab": "Commencer",
+      "groups": [
+        {
+          "group": "Vue d'ensemble",
+          "pages": ["fr/index"]
+        },
+        {
+          "group": "Premiers pas",
+          "pages": ["fr/start/getting-started", "fr/start/wizard"]
+        }
+      ]
+    }
+  ]
+}

package/docs/.i18n/glossary.ar.json

@@ -0,0 +1,82 @@
+[
+  {
+    "source": "ACP",
+    "target": "ACP"
+  },
+  {
+    "source": "Active Memory",
+    "target": "Active Memory"
+  },
+  {
+    "source": "ClawHub",
+    "target": "ClawHub"
+  },
+  {
+    "source": "CLI",
+    "target": "CLI"
+  },
+  {
+    "source": "Compaction",
+    "target": "Compaction"
+  },
+  {
+    "source": "Cron",
+    "target": "Cron"
+  },
+  {
+    "source": "Dreaming",
+    "target": "Dreaming"
+  },
+  {
+    "source": "Gateway",
+    "target": "Gateway"
+  },
+  {
+    "source": "Heartbeat",
+    "target": "Heartbeat"
+  },
+  {
+    "source": "LINE",
+    "target": "LINE"
+  },
+  {
+    "source": "Mintlify",
+    "target": "Mintlify"
+  },
+  {
+    "source": "Node",
+    "target": "Node"
+  },
+  {
+    "source": "OpenClaw",
+    "target": "OpenClaw"
+  },
+  {
+    "source": "Pi",
+    "target": "Pi"
+  },
+  {
+    "source": "Plugin",
+    "target": "Plugin"
+  },
+  {
+    "source": "Skills",
+    "target": "Skills"
+  },
+  {
+    "source": "Tailscale",
+    "target": "Tailscale"
+  },
+  {
+    "source": "TaskFlow",
+    "target": "TaskFlow"
+  },
+  {
+    "source": "TUI",
+    "target": "TUI"
+  },
+  {
+    "source": "Webhook",
+    "target": "Webhook"
+  }
+]