friendo-bot

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 25 Open GitHub ↗

A Discord Bot that is just a good Friendo

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Friendo Bot
This is a Discord bot that comforts you when you are lonely, is there for you in the middle of the night,
keeps you hydrated, and does all of your bidding like a ~~sexy~~ butler with a true passion for what they do.

More usefully described, Friendo is a multi-purpose Discord bot that provides a unique assortment of tools and
entertainment to users in your server.

If you are a Friendo user, consider utilizing the official [Friendo Website](https://friendo.dev/) for extra
capabilities of the hosted version of the bot.

## Discord Bot Setup

To get a bot token go to [Discord Developer Portal](https://discord.com/developers/applications), create
 a new application and add a bot.

## Production Installation
1. `git clone <url>`

2. Create an [imgflip](https://api.imgflip.com/) api account

3. Create a [Ticketmaster](https://developer.ticketmaster.com/products-and-docs/apis/getting-started/) api account

4. Create a [Last.fm](https://www.last.fm/api) api account

5. Create a [Open Weather](https://openweathermap.org/price) api account (a free account works for this)

6. Get your AoC session cookie, see how - https://github.com/wimglenn/advent-of-code-wim/issues/1

7. Create a file `.env` in the root project directory and fill it out using the example below

8. `docker compose pull bot`

9. `docker compose up --build -d`

```text
# .env

FRIENDO_TOKEN = <your token here>
MEME_USERNAME = <your imgflip api username>
MEME_PASSWORD = <your imgflip api password>
EVENT_API_KEY = <your ticketmaster api key>
MUSIC_TOKEN = <your Last.fm api key>
WEATHER_TOKEN = <your open weather token>
AOC_SESSION_COOKIE = <your advent of code session cookie>
FRIENDO_API_USER = <your friendo api username>
FRIENDO_API_PASS = <your friendo api password>
FRIENDO_API_URL = <friendo api url>
AOC_SESSION_COOKIE = <your aoc session cookie>
AOC_JOIN_CODE = <aoc join code>
```

## Dev Installation
You can use the above docker method to run in a dev environment or use uv.
(if using uv for local development, the above environment variables must be added to the system or a file named `.env`).*

```bash
# Clone the repository on the develop branch
$ git clone -b "develop" https://github.com/fisher60/friendo-bot.git

# Create a .venv & install dependencies using the make target
$ make

# Optionally: run pre-commit hooks to initialize them
$ make lint

# Run the bot
$ uv run python -m bot
```

friendo-bot

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

friendo-bot

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README