Credentials. The local JSON config holds your model API key and CLS credentials, so keep config/project.json and config/user.project.json out of version control.
Who it is forAn engineer who wants to test alert diagnosis on their own machine before trusting it with real alert data.
The problemRunning the diagnosis pipeline needs Kafka, Redis, Milvus, the API, the event worker, and the frontend all started and wired to model and CLS settings.
The outcomeA running local workspace where you can open a chat or diagnosis session and watch progress stream in the browser.
What you need first
- Python 3.10+, uv, Node.js 22+, and Docker Compose installed locally
- Access to a configured Qwen-compatible model service and its API key
- Tencent CLS credentials if you use the CLS integration
- Git clone of kkjiangk/agent-py
Steps
- Run
npm ciat the repository root. - Run
cp config/project.template.json config/project.jsonandcp config/user.project.template.json config/user.project.json. - Edit both local JSON files to set the model API key, chat and embedding model names, and the required CLS fields.
- Run
./scripts/start-local.sh. - Open
http://127.0.0.1:5173in a browser to use the workspace.
Prompt for your agent
In the kkjiangk/agent-py repository, follow the local development steps in its README to start the stack with ./scripts/start-local.sh. Report which of the frontend, API, and Alertmanager addresses responded. Verify that http://127.0.0.1:8000/docs loads before you finish.
Caveat. The workspace UI is in Chinese, and the setup needs a Qwen-compatible model service and, for CLS, Tencent credentials.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Disclaimer
Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked "Seen in the wild", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email [email protected] and we will look at it promptly. Full disclaimer page