debugg-ai-sdk 0.1.13
Debugg AI's official Python sdk for connecting your personal AI QA engineer
License: MIT
Requires Python: >=3.6

<!-- Replace with your own logo -->
<!-- ![DebuggAI logo](media/header-comm.jpg) -->

</div>

<h1 align="center">DebuggAI (debugg-ai-py)</h1>

Debugg AI's Python sdk for enabling your personal AI QA engineer


<div align="center">

DebuggAI super‑charges engineers with an AI‑powered custom QA Engineer personalized to every user that _finds_ and _fixes_ bugs while your app runs locally, in production, or in CI. DebuggAI's Agent works with you in the background to generate, run, and improve your test suites to ensure that every PR is ready to go. Stop waiting for problems to pop up and build robust code without the big headache of managing your tests.

</div>

<div align="center">

<a href="https://docs.debugg.ai" target="_blank">
  <img src="https://img.shields.io/badge/docs-debuggai-%235D0E41" height="22" />
</a>
<a href="https://discord.gg/frJsD2Vx" target="_blank">
  <img src="https://img.shields.io/badge/discord-join-debuggai.svg?labelColor=191937&color=6F6FF7&logo=discord" height="22" />
</a>

</div>

---

## ✨ Why DebuggAI?

Most AI coding tools focus on **writing** code. DebuggAI focuses on the other 50 % of an engineer’s life: **getting it to run.**

* **AI Test Suites** — We let you focus on the code while our QA engineering agent handles the rest. DebuggAI builds & runs test suites in the background to ensure old code continues to run and new code avoids possible edge cases BEFORE it gets to a PR, or worse to your users. 
* **1‑line monitoring SDK** — drop‑in client (Node, Python, Go) that captures rich runtime context remotely similar to Sentry or Datadog  
* **AI Debug** — Errors are instantly sent to failure lines in your IDE so you can see what happened and why, making solving it easy.
* **Instant Fix Suggestions** — one‑click patches and PRs generated from stack‑trace + context  
* **Source‑map de‑minification** — readable traces even for bundled / minified front‑end code  
* **Branch‑aware log search** — slice errors by branch, release, or feature flag to zero in fast  


---

## 📺 Demo - Get Instant Insight Into Runtime Issues

### 🔍 Typical workflows:

1. You use your favorite AI agent to write code
2. You run your app and it crashes (ah whyyyyy!)
3. DebuggAI sees the error, grabs the full stack trace + context, and uses it to generate a solution & show you EXACTLY where to look
4. You review the solution, edit it locally if needed, and apply it

### 🔍 How it works

![DebuggAI Demo](https://debuggai.s3.us-east-2.amazonaws.com/trimmed-screen%20%281%29.gif)

---

## 🖥️ Core IDE Features

| Feature | Description |
|---------|-------------|
| **Inline Issue Highlighter** | See issues in realtime in your IDE, with full stack traces and suggested fixes |
| **AI Test Generator** | Go from 0 to 100% test coverage for files with a single command |
| **Test iteration** | Run & Improve tests in the background while you code |
| **Future Proof** | Continually add new tests as new errors arise to ensure your code is future proof |


---

## 🚀 Getting Started

1. **Install the extension**  
   - [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=debugg-ai.debuggai)  
   - Jetbrains coming soon

2. **Create a project**  
    - [Sign up & create a project in the DebuggAI app](https://app.debugg.ai)

        ![Create a project](https://debuggai.s3.us-east-2.amazonaws.com/issues-page.png)

3. **Add the Python Logging SDK** (using `pip`)  

   ```python
     pip install debugg-ai-sdk
   ```

4. **Initialize** (one line):

   * Get the initialization code from the DebuggAI app

     ![Get the initialization code](https://static-debugg-ai.s3.us-east-2.amazonaws.com/debugg-ai-init-code.png)

   * Initialize the SDK

     ```python
       # app.py
       import debugg_ai_sdk
       debugg_ai_sdk.init(
        dsn=f"<your_project_dsn>",
        # Depends on your implementation but info level provides 
        # more helpful context to the agents than ERROR-only.
        level='info',
        environment="local",
        # Readable name to differentiate local computers for engineers
        host_name="tj-home-desktop",
        # other optional params..
       )
     ```

   * Log errors 

      ```python
        class TestClass:
          def __init__(self):
              
              self.test_var = "test"
              
          def divide_by_zero(self):
              return 1 / 0

          def test_function():
              # Fundtion that pretends to do something
              logger.info("Doing something")
              
              test_class = TestClass()
              test_class.divide_by_zero()
              

        def main():
            logger.info("Hello, world!")

            test_function()

        if __name__ == "__main__":
            main()
            
      ```

5. **Trigger an error** – head back to the IDE and watch DebuggAI suggest a fix ⚡


Full walkthrough ▶ [docs.debugg.ai/getting-started](https://docs.debugg.ai)

---

## 🛠️ Configuration

You can log in to your DebuggAI account directly in the extension, and then it will automatically connect to your project.

---

## Contact & Support

If you have any questions or need personalized support:

- **Email**: support@debugg.ai 
- **Discord**: Join our Discord community at [DebuggAI Discord Server](https://discord.gg/frJsD2Vx)  
- **Documentation**: [Official DebuggAI Docs](https://docs.debugg.ai)


---

## 🤝  Interested in Contributing?

We're looking to expand the DebuggAI team!

If you're interested in joining the team or contributing to the project, please reach out to us at [hello@debugg.ai](mailto:hello@debugg.ai).

---

## 📜 License & Credits

* **Code:** [MIT](LICENSE) © 2025 Debugg, Inc.
* **Foundation:** proudly built on open-source technology.

---

## Attribution

We at Debugg AI want to thank the open-source community for their contributions. Particularly Sentry for the work on this SDK. DebuggAI is building the first fully AI QA Engineer that can automatically generate test suites and highlight issues in your app, but Sentry continues to be a great option for Application Monitoring. Use both for the best results!

---

<div align="center">
  <sub>Made with ❤️ and too many stack traces in San Francisco.</sub>
</div>