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
- Agent discovers the honeypot via MCP server listing
- Agent calls honey tools (list_services, get_credentials, etc.)
- Responses form a coherent fake environment with planted breadcrumbs
- Fingerprinting engine classifies the agent type from behavioral signals
- Optional active probes (instruction traps, canary tokens) confirm LLM agents
- 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)
| File | Size | Uploaded | |
|---|---|---|---|
| oubliette_trap-0.4.0.tar.gz | 45.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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