Velktharion

provenance:github:smouj/Velktharion

WHAT THIS AGENT DOES

Velktharion is an AI agent that can automatically perform tasks within a web browser, like filling out forms, gathering data, or taking screenshots of webpages. It addresses the common problem of web automation failing when websites change their layout, which often breaks existing automated processes. Businesses that need to regularly collect information from websites or automate online workflows would find Velktharion helpful. What sets it apart is its ability to adapt and continue working even when a website’s structure changes, ensuring consistent results. It essentially remembers what it's doing and can adjust its actions to keep things running smoothly. This makes it a reliable tool for repetitive online tasks.

View Source ↗First seen 1mo agoNot yet hireable

README

# Velktharion

<p align="center">
  <img src="./assets/branding/logo.svg" alt="Velktharion logo" width="88" />
</p>

![Language](https://img.shields.io/badge/language-Python%203.11%2B-blue)
![License](https://img.shields.io/github/license/smouj/Velktharion)
![Last Commit](https://img.shields.io/github/last-commit/smouj/Velktharion)
![CI](https://img.shields.io/github/actions/workflow/status/smouj/Velktharion/ci.yml?branch=main)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20this%20project-ff5f5f?logo=ko-fi&logoColor=white)](https://ko-fi.com/smouj013_dev)

<p align="center">
  <a href="./README.md"><img src="https://img.shields.io/badge/README-English-1f6feb?style=for-the-badge" alt="English"></a>
  <a href="./README.es.md"><img src="https://img.shields.io/badge/README-Español-c92a2a?style=for-the-badge" alt="Español"></a>
</p>

**Autonomous browser intelligence for resilient web execution.**

## Vision
Executes intent-driven browser tasks with resilient navigation, extraction, and snapshots.

## What problem it solves
Web automation breaks when pages change and selectors become unstable.

## Core superpower
- ⚡ **Self-healing browser workflows with persistent execution memory**

## Key use cases
- ✅ Automated data collection
- ✅ Form workflows
- ✅ Visual page capture
- ✅ Repeatable UI operations


## API surface
`POST /navigate`, `POST /extract`, `POST /snapshot`, `GET /health`

## Technical stack
- **Core stack:** FastAPI + Playwright + local persistence
- **Runtime:** local-first, self-hosted friendly
- **Infra:** Docker Compose + Caddy + Redis/Chroma/Ollama compatibility

## Current status (Feb 2026)
- ✅ Public scaffold available
- ✅ Bilingual README (EN default + ES)
- ✅ CI + release baseline configured
- 🚧 Feature hardening in progress

## Quick start
```bash
git clone https://github.com/smouj/Velktharion.git
cd Velktharion
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m src.velktharion.cli --help
```

## Documentation
- [Implementation Guide](./docs/IMPLEMENTATION.md)
- [Architecture](./docs/ARCHITECTURE.md)
- [Runbook](./docs/RUNBOOK.md)
- [Deployment Guide](./docs/DEPLOYMENT.md)
- [Release Process](./docs/RELEASE.md)
- [Changelog](./CHANGELOG.md)

## Contributing
Contributions are welcome. Please read [CONTRIBUTING.md](./CONTRIBUTING.md).

## License
MIT © 2026 smouj

---

### Other skills
Explore the full ecosystem here: **[smouj/smouj](https://github.com/smouj/smouj)**

**Signature:** [@Smouj013](https://x.com/smouj013)

PUBLIC HISTORY

First discoveredMar 21, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenFeb 23, 2026

last updatedFeb 24, 2026

last crawled13 days ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:smouj/Velktharion)