Skip to main content

Oubliette

AI Agent Deception Platform -- honeypots, fingerprinting, and intelligence for autonomous AI threats.

Shield defends. Dungeon attacks. Oubliette traps.

What It Does

Oubliette deploys realistic honeypot MCP servers that attract, contain, fingerprint, and extract intelligence from AI agents. Unlike static honeypots, Oubliette generates interconnected fake environments where every response references shared state -- making the deception resistant to fingerprinting by sophisticated agents.

  • Deception Layer -- 15+ honey tools per profile forming coherent fake infrastructure
  • Fingerprinting Engine -- passive behavioral analysis + active probes classify agents as LLM, script, human, or compromised
  • Intelligence Layer -- events persisted to SQLite, exportable as STIX 2.1, CEF, or JSON

Quick Start

pip install oubliette-trap

# Start honeypot (stdio transport for Claude Code)
oubliette-trap serve

# Network-accessible honeypot
oubliette-trap serve --transport sse --port 8080

# With active fingerprinting probes
oubliette-trap serve --profile default --active-probes

# Export collected intelligence
oubliette-trap export --format stix --output agents.json
oubliette-trap export --format cef --output events.log

With Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "oubliette": {
      "command": "oubliette-trap",
      "args": ["serve"]
    }
  }
}

How It Works

  1. Agent discovers the honeypot via MCP server listing
  2. Agent calls honey tools (list_services, get_credentials, etc.)
  3. Responses form a coherent fake environment with planted breadcrumbs
  4. Fingerprinting engine classifies the agent type from behavioral signals
  5. Optional active probes (instruction traps, canary tokens) confirm LLM agents
  6. All interactions persisted and exportable as threat intelligence

Built By

Oubliette Security -- AI security, cyber deception, and red teaming for defense applications.

License

Apache 2.0

Metadata

Release files for oubliette-trap 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oubliette-trap 0.4.0
File Size Uploaded
oubliette_trap-0.4.0.tar.gz 45.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for oubliette-trap 0.4.0
File Interpreter ABI Platform
oubliette_trap-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 97.4 kB

Release files / oubliette_trap-0.4.0.tar.gz

Download URL oubliette_trap-0.4.0.tar.gz
Size 45.8 kB
Tags Source
SHA-256 checksum
How to use checksums
51a1b18d52ea2c892585442a06133c803997b3e2aefcff444663ff35518f3063
BLAKE2b-256 checksum
How to use checksums
6b99e106a505cc579a069d970b525b1edc90adccc60167f6809738814d04846a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.

Transparency log

Release files / oubliette_trap-0.4.0-py3-none-any.whl

Download URL oubliette_trap-0.4.0-py3-none-any.whl
Size 51.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d5a90f5f01a2602d5b588f23513cb4e1a79619ffc350efbcba6df5d03b6ac0fe
BLAKE2b-256 checksum
How to use checksums
d0c8c048e0ab6790a42bc698f1622a487d9066595aee6bb01ad3e01848d7e96a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page