🌳 Arborito

The Visual Browser for Decentralized Knowledge

This is the frontend repository for Arborito. It acts as a "player" or "browser" that visualizes knowledge trees. It is a serverless, zoneless, vanilla JS application.

🔗 Official knowledge source

By default, this application connects to the official Arborito Library repository:

👉 github.com/treesys-org/arborito-library

The UI loads the data.json file generated by that repository.

✨ Features

• Visual exploration: Navigate complex topics like an interactive mind map.
• Decentralized: Can load any external "Tree" (JSON file) via URL.
• Zero build: Runs 100% in the browser (Vanilla JS + Tailwind via CDN).
• Open source: GPL-3.0 License.

🚀 How to run

1. Clone this repository.
2. Open index.html in your browser.
   • Note: For better performance and to avoid CORS issues with local files, it is recommended to use a simple local server like python -m http.server or the Live Server extension in VS Code.
3. The app will automatically fetch the latest content from the cloud (Arborito Library).

🧠 AI integration (Ollama)

Arborito supports local AI via Ollama.

Option A: Using web browser (Chrome/Firefox/Safari)

Due to browser security (CORS), you must configure Ollama to allow requests from the browser:

1. Stop Ollama.
2. Run with the origin flag:

   OLLAMA_ORIGINS="*" ollama serve

Option B: Using desktop app (Electron)

The desktop version handles permissions automatically. You do not need the OLLAMA_ORIGINS flag.

1. Install dependencies: npm install
2. Run app: npm start

🛠️ Development

This project uses no build tools (No Webpack, No Vite, No Angular CLI). It uses native ES Modules.

• src/: Contains the application logic (Store, Components, Services).
• index.html: The main entry point.

🤝 Contribute

• To improve the interface: Submit PRs to this repository.
• To improve the content: Submit PRs to the Arborito Library repository.

📄 License

Arborito is licensed under the GNU General Public License v3.0.