sauce-man

• sauce-man is services which includes:
  • bot: a discord bot to make discord app bertter to:
    • Fix Links Previews
    • reverse image search
    • query user messages and also:
    • prometheus metrics
    • opentelemetry instrumentation
  • api: a FastAPI to interact with bot
  • bot management dashboard: matain bots via api
  • mcp-server: MCP is an open protocol that standardizes how applications provide context to LLMs.

quick-start

#backend
#discord-bot
uv run backend/manage.py runbot --uv
# uv run --python=python3.10 backend/manage.py runbot --uv

#FastAPI
uv run --python=python3.10 backend/manage.py runapi 0.0.0.0 8000 --uv

#setting up 
bash scripts/uv_tools.sh

#build docker container image
docker build . -t docker.io/focal1119/sauce-man:test

#run container with docker run
docker run -d --env-file=backend/core/.env --name sauce-man docker.io/focal1119/sauce-man-bot:2025-02-27-15-57

#run with docker compose
#up and run in background
docker compose up -d

#down
docker compose down

misc

Reference implementation

• github.com/practical-tutorials/project-based-learning?tab=readme-ov-file#python
• modelcontextprotocol.io/introduction
• ermiana
  • A Discord bot that fixes sites with broken preview by providing more detailed images and webpage content. Supports multiple popular sites in Taiwan, East Asia.
• bckbot
  • A discord bot powered by discord.js
• how-do-i-apply-environment-variables-to-python-interactive
• pprint
• os.environ
• sqlalchemy/postgresql
• pandas
• decorator
• await fetch_message
• read_message_history
• async for ... in history
• discord.py/examples/
• How to retrieve previous messages with discord.py
• How could I grab all chat messages in a specific channel in a discord server using discord.py?
• Community Resources
• discord.com/developers/docs/getting-started
• Discord bot that automatically download images from a channel.
  • d-logger.py
• discord.py/intro
• events
  • coroutine
    • asyncio

Important!!!

== We're Using GitHub Under Protest ==

This project is currently hosted on GitHub. This is not ideal; GitHub is a proprietary, trade-secret system that is not Free and Open Souce Software (FOSS). We are deeply concerned about using a proprietary system like GitHub to develop our FOSS project. We have an open {bug ticket, mailing list thread, etc.} where the project contributors are actively discussing how we can move away from GitHub in the long term. We urge you to read about the Give up GitHub campaign from the Software Freedom Conservancy to understand some of the reasons why GitHub is not a good place to host FOSS projects.

If you are a contributor who personally has already quit using GitHub, please check this resource for how to send us contributions without using GitHub directly.

Any use of this project's code by GitHub Copilot, past or present, is done without our permission. We do not consent to GitHub's use of this project's code in Copilot.