Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ Now you're ready to use pre-commit hooks in your project! Explore the list of ho

## 🌐Languages

- [AKF — The AI Native File Format](languages/AKF.md)
- [Python](languages/Python.md)

## 🤝Contributing
Expand Down
50 changes: 50 additions & 0 deletions languages/AKF.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# AKF — The AI Native File Format

## Overview

- **GitHub Repository:** [AKF Pre-Commit Hooks](https://github.com/HMAKT99/akf-pre-commit)
- **Category(ies):** AI, Metadata, Compliance, Trust

## Tutorial

### What is AKF?

AKF (Agent Knowledge Format) is the AI native file format — EXIF for AI. It embeds trust scores, source provenance, and compliance metadata into every file your AI touches. ~15 tokens of JSON that travel with the file across 20+ formats (DOCX, PDF, images, code).

### Why Use AKF with Pre-Commit?

As AI generates more code and content, every committed file should carry provenance — who generated it, what model, what confidence level, what sources. The AKF pre-commit hook auto-stamps this metadata on every commit, so your entire repo carries trust data.

This is especially important with the EU AI Act Article 50 taking effect August 2, 2026, requiring transparency metadata on AI-generated content.

### Installation via Pre-Commit Hook

First install the AKF CLI:

```bash
pip install akf
```

Then add the following to your `.pre-commit-config.yaml`:

```yaml
repos:
- repo: https://github.com/HMAKT99/akf-pre-commit
rev: v1
hooks:
- id: akf-stamp
- id: akf-audit
```

### Available Hooks

| Hook | Description |
|------|-------------|
| `akf-stamp` | Stamps committed files with trust metadata (trust scores, provenance) |
| `akf-audit` | Checks files against EU AI Act Article 50 compliance |

### Links

- **Website:** [akf.dev](https://akf.dev)
- **Main Repo:** [HMAKT99/AKF](https://github.com/HMAKT99/AKF)
- **Demo:** [HuggingFace Space](https://huggingface.co/spaces/HANAKT19/akf)