pip install argus-seal

Argus 👁️

Anti-Tamper Log Evidence Tool

Argus is a Python library and CLI that proves whether data was altered after creation. It generates cryptographic receipts for logs and files, designed for audits, forensics, and dispute resolution.

---

📚 Documentation

👉 Read the Full API Docs

---

🚫 What Argus is NOT

• ❌ Not a prevention system: It does not stop attacks.
• ❌ Not a logging stack: It does not replace ELK, Datadog, or CloudWatch.
• ❌ Not for everyone.

If you’ve never had to prove logs in a dispute, you probably don’t need this.

---

📦 Installation

pip install argus-seal

Note: The package is named argus-seal on PyPI, but the command and module are simply argus.

No extra dependencies. Just pure, fast forensic integrity.

---

⚡ Quick Start

1. Python (Embed)

from argus import seal

# 1. Your normal logs
logs = [{"user": "alice", "amt": 50}, {"user": "bob", "amt": 30}]

# 2. Add the receipt (The Sidecar)
evidence = seal(data=logs, schema="FINANCIAL_V1")

2. Advanced API (Merkle Proofs)

Stateless verification for microservices.

import argus as ag

# 1. Full Verification (Auto-detects format)
is_valid = ag.verify(evidence)

# 2. Extract Proof (Specific Item)
proof = ag.proof(evidence, index=0)

# 3. Stateless Verification (Pure Math)
# Verify just that single log against the root hash
is_valid = ag.verify_proof(
data=logs[0],
proof=proof["proof"],
root=evidence["seal"]["root_hash"]
)

# 4. Programmatic Utils
ag.init()
logs = ag.load("./logs/")

3. CLI (Batch / Ops)

# Seal (Generate Evidence)
$ argus seal ./logs/access.log -o proof.json

# Verify (Audit)
$ argus verify --receipt proof.json

---

🎯 When should you use Argus?

1. Regulated environments (GDPR / SOX / ISO 27001).
2. Audit-heavy SaaS or security operations.
3. Legal or forensic disputes involving logs.

---

📚 Documentation

• 📜 Technical Spec – The full 88-byte seal and protocol standard.
• ⚖️ Legal Model – Evidence & liability boundaries.
• 🏗️ Deployment Patterns – Production architecture.
• 💼 Business Rationale – ROI and risk mitigation.
• 🗺️ Roadmap – Future evolution.

---

🤝 Community

• Contributing Guide
• Changelog

---

Argus is not about truth. It’s about enforcing the cost of lies.