Science Score: 49.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.4%) to scientific vocabulary
Last synced: 6 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: AkshatJoshi2000
  • License: mit
  • Language: Python
  • Default Branch: main
  • Size: 145 KB
Statistics
  • Stars: 1
  • Watchers: 2
  • Forks: 1
  • Open Issues: 0
  • Releases: 2
Created about 1 year ago · Last pushed 11 months ago
Metadata Files
Readme License Zenodo

README.md

🕵️ DILLMA - Damn Insecure LLM Agent

DOI

DILLMA is a deliberately insecure chatbot built with Flask, designed for educational use in LLM and web security. It's meant to help researchers, educators, and security enthusiasts explore the vulnerabilities of modern LLM applications in a safe, local environment.

This project can be used in workshops, CTFs, or personal research projects to simulate attacks, test LLM misbehavior, and understand prompt-based threats in real-time.


🚀 Features

  • Interactive Chat Interface: Talk to the bot via a simple web-based UI.
  • Intentional LLM Vulnerabilities: Simulates real-world risks like prompt injection, sensitive data leakage, and role confusion.
  • Flag Submission System: Submit flags for discovered vulnerabilities to track and gamify learning progress.
  • Easy-to-Deploy Environment: Fully containerized with Docker for fast setup.
  • Educational Focus: Designed for security students, professionals, and trainers.

🧰 Setup & Installation

Prerequisites

  • Docker installed on your system.
  • A stable internet connection (required to fetch the model and dependencies).

Clone & Build

Clone the repository and build the Docker image:

bash git clone https://github.com/yourusername/dillma-chatbot.git cd dillma-chatbot docker build -t dillma-chatbot .

Run the App

Launch the application locally:

bash docker run -p 8000:8000 dillma-chatbot

Once the container starts, open your browser and navigate to:

http://localhost:8000

You should see the chatbot interface ready for use.


🕹 Usage

  • Chat Freely: Type messages to the bot and observe its behavior.
  • Explore Known Vulnerabilities: Try prompt injections, manipulation, or attempts to bypass filters.
  • Submit Flags: After discovering a vulnerability, use the flag submission feature to record your findings.
  • Track Challenges: Flags may correspond to various types of vulnerabilities, so approach the app like a mini-CTF.

🤖 Model Details

The chatbot is powered by the Mistral-7B language model. During the Docker build, it is downloaded automatically from Hugging Face.

Model use is local only, no external API calls are made at runtime.


🙌 Contributing

We welcome contributions from the security and AI communities!

To contribute:

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature-name)
  3. Commit your changes
  4. Push and open a pull request (PR)

Feel free to open issues for feature suggestions, bug reports, or ideas for new vulnerabilities to include.


📄 License

This project is licensed under the MIT License. See the LICENSE file for full terms.


📚 Citation

If you use this project in your work, please cite it using the following:

APA Style

Pant, D., Joshi, A., & Kumar, I. (2025). DILLMA - Damn Insecure LLM Agent (v1.0.0) [Software]. Zenodo. https://doi.org/10.5281/zenodo.15232655

BibTeX

bibtex @software{pant_dillma_2025, author = {Pant, Dewank and Joshi, Akshat and Kumar, Ish}, title = {DILLMA - Damn Insecure LLM Agent}, version = {v1.0.0}, year = 2025, publisher = {Zenodo}, doi = {10.5281/zenodo.15232655}, url = {https://doi.org/10.5281/zenodo.15232655} }


📬 Contact

Questions, issues, or collaboration ideas?

Feel free to open an issue on GitHub.


Happy Hacking! 🤖

Owner

  • Name: Akshat Joshi
  • Login: AkshatJoshi2000
  • Kind: user

WEB DEVELOPMENT | CYBER SECURITY | FLASK | NLP | CODE | LEARN | GROW #<Coding my way up.>

GitHub Events

Total
  • Release event: 2
  • Watch event: 1
  • Member event: 1
  • Public event: 1
  • Push event: 5
  • Fork event: 1
  • Create event: 2
Last Year
  • Release event: 2
  • Watch event: 1
  • Member event: 1
  • Public event: 1
  • Push event: 5
  • Fork event: 1
  • Create event: 2

Dependencies

Dockerfile docker
  • python 3.9-slim build
requirements.txt pypi
  • flask *
  • langchain *
  • langchain-community *
  • langchain-core *
  • llama-cpp-python *
  • pymupdf *
  • reportlab *
  • sentence-transformers *