BotKit by Fedify

Introducing #BotKit: A #TypeScript framework for creating truly standalone #ActivityPub bots!

Unlike traditional Mastodon bots, BotKit lets you build fully independent #fediverse bots that aren't constrained by platform limits. Create your entire bot in a single TypeScript file using our simple, expressive API.

Currently #Deno-only, with Node.js & Bun support planned. Built on the robust @fedify foundation.

https://botkit.fedify.dev/

What kind of bot would you like to see being created using #BotKit in the tutorial? (Ideas are welcome!)

#BotKit now supports #hashtags in your bot messages!

You can now add searchable hashtags to your bot's posts using either our dedicated hashtag() function or through BotKit's extended Markdown syntax. This makes your bot's content more discoverable across the fediverse and helps engage with broader conversations.

Whether you're building a news bot, content curator, or community engagement tool, hashtags can help your bot reach the right audience.

Check out our docs to learn more about implementing hashtags in your bots!

#ActivityPub #fediverse #fedidev #botdev

Are you interested in creating bots for the #fediverse? Meet #BotKit, a #TypeScript framework that makes bot development easier than ever!

Key Features:

True Independence

• Create standalone #ActivityPub bots
• No need for a Mastodon or Misskey account
• Free from platform-specific limitations

Simple and Intuitive API

• Create a complete bot in a single TypeScript file
• Intuitive event handlers for mentions, follows, and messages
• Rich text formatting with Markdown support

Modern Deployment

• Deploy on Deno Deploy, Fly.io, Railway, or any virtual server
• Minimal dependencies
• Designed for modern cloud platforms

Enterprise-Ready Foundation

• Built on Fedify, a rock-solid ActivityPub framework
• Seamless federation with Mastodon, Misskey, and other platforms
• Robust compatibility across the fediverse

Developer Experience

• Full TypeScript support with great IDE integration
• Comprehensive documentation
• Built-in testing utilities

Here's a quick example of how simple it is to create a bot:

import { createBot, mention, text } from "@fedify/botkit";

const bot = createBot<void>({
  username: "greetbot",
  name: "Greet Bot",
  summary: text`A friendly bot that greets people!`,
  // ... configuration ...
});

// Respond to mentions
bot.onMention = async (session, message) => {
  await message.reply(text`Hi, ${message.actor}! Thanks for saying hello!`);
};

export default bot;

Getting Started:

1. Install #Deno
2. Run: deno add jsr:@fedify/botkit@^0.1.0-dev
3. Create your bot with just a few lines of code

Check out our documentation at https://botkit.fedify.dev/ to learn more!

#fedidev

📢 Important announcement! #BotKit's #GitHub repository has moved to a new home! 🏠

The repository is now located at @fedify-dev/botkit (previously @dahlia/botkit). All future development will continue at the new location.

Don't worry—everything's the same, just a new address! Please update your bookmarks and project references. Thanks for being part of our community!

#Fedify #ActivityPub #fediverse #fedidev

https://hollo.social/@fedify/0194a851-581d-779c-b777-dc39e753ef14

We've just moved the #Fedify project and related repositories to our new GitHub organization account, @fedify-dev! 🎉

Here's what moved:

• @dahlia/fedify → @fedify-dev/fedify
• @dahlia/botkit → @fedify-dev/botkit
• @dahlia/hollo → @fedify-dev/hollo
• @dahlia/fedify-amqp → @fedify-dev/amqp
• @dahlia/fedify-h3 → @fedify-dev/h3
• @dahlia/fedify-express → @fedify-dev/express
• @dahlia/fedify-postgres → @fedify-dev/postgres
• @dahlia/fedify-redis → @fedify-dev/redis
• @dahlia/markdown-it-hashtag → @fedify-dev/markdown-it-hashtag
• @dahlia/markdown-it-mention → @fedify-dev/markdown-it-mention
• @dahlia/fedichatbot → @fedify-dev/fedichatbot
• @dahlia/microblog → @fedify-dev/microblog

All repositories have been transferred and GitHub's automatic redirects are in place, so existing links will continue to work. Also, the project's core functionality and development process remain unchanged.

Thanks to everyone who participated in our naming poll. Looking forward to Fedify's continued growth under its new organizational home!

New GitHub organization: https://github.com/fedify-dev.

#BotKit's web interface now supports theme customization! 🎨 You can set your preferred color theme using the pages.color option in createBot(). Here are some examples showing the same interface in different colors: "violet", "pumpkin", "azure", and "green" (default).

const bot = createBot<void>({
  // ... other options
  pages: {
    color: "violet"  // or "pumpkin", "azure", etc.
  }
});

We support all color themes from Pico CSS—including "amber", "fuchsia", "indigo", "jade", "lime", "pink", "sand", "slate", "yellow", "zinc", and more! Check out Pico CSS's Colors docs for the full list of available themes.

Which color is your favorite? 🤔

#ActivityPub #fediverse #fedidev

BotKit bots now come with built-in Atom feeds! Every bot created with BotKit automatically provides an Atom feed of its posts. Another way to keep up with your favorite bots!

#BotKit now comes with a built-in web interface! Your fediverse bots will have profile pages and permalink pages for posts, right out of the box. Check out the screenshot to see how it looks.

Exciting update on #BotKit: we've introduced a new Repository abstraction layer that provides cleaner data access. While previously data operations went directly through KvStore, they now go through Repository—improving separation of concerns and making the codebase more maintainable. Don't worry though—there are no breaking changes to the public API that BotKit users rely on!

Key benefits:

• Better abstraction over data sources
• Cleaner internal architecture
• Fully backwards compatible

Check out our docs for the technical details: https://botkit.fedify.dev/concepts/repository.

#ActivityPub #fediverse #fedidev #BotKit

https://hollo.social/@hongminhee/0194a0d4-1d67-7c81-80ba-e7ade212d27a

Okay, since we couldn't get in touch with the @fedify account owner, we need a new name for our GitHub organization. Which alternative do you prefer?

Your suggestions for other names are welcome in the comments! We'll make the final decision based on your feedback.

#Fedify already uses the #Temporal API exclusively for representing temporal data.

https://developer.mozilla.org/en-US/blog/javascript-temporal-is-coming/

Once we have a @fedify org account, we'll be moving #BotKit's repository there as well.

https://hollo.social/@fedify/01949657-262f-78f4-a9a0-97643682ea70

We're planning to move our GitHub repository to an organization account for better project management. We've requested GitHub support to help us acquire the inactive @fedify username for this purpose. (The attached screenshot is our formal request to GitHub support.)

If we successfully acquire @fedify, that will be our new organization name. If not, we'll choose an alternative name. We'll keep you updated on the progress!

In any case, we'll ensure a smooth transition with proper redirects from the current repository. Stay tuned for updates!

#BotKit now allows messages to update().

If you'd like to support the development of @fedify or @hollo or @botkit, you can sponsor me on GitHub!

https://github.com/sponsors/dahlia

#ActivityPub #fedidev #Fedify #Hollo #BotKit #sponsor

The #BotKit docs now have Recipes! It contains practical examples for common tasks like:

• Sending a direct message
• Following back
• Automatically deleting old messages
• Scheduled messages
• Automatically replying to mentions
• Thread creation
• Thread traversal

More recipes are on the way. Check it out now.

#ActivityPub #fediverse #fedidev #botdev #BotKit

#BotKit's Message object is backed by @fedify's Activity Vocabulary objects, and you can access it through the Message.raw property.

New: Last Week in #Fediverse - ep 100 (!)

This week's news:
- massive growth for @pixelfed, growing from 20k active users last month to almost 200k active users currently.
- @nodebb has officially launched their #activitypub integration
- Meta will not commit or confirm a timeline for adding account migration to #threads

Thank you to everyone for reading and supporting 100 editions of Last Week in Fediverse!

Read at: https://fediversereport.com/last-week-in-fediverse-ep-100/

@liaizon You can get the location data through Message.raw property!

bot.onMention = async (session, message) => {
  const location = await message.raw.getLocation();
  if (location instanceof Place) {
    console.log(location.name);
    console.log(location.longitude);
    console.log(location.latitude);
  }
};

See also the Place class from Fedify.

What's a higher priority for #BotKit?

＞BT
その場でAccept/Rejectを決められない場合がありそうなので、2番目に投票した（followRequestをどこかに保存しておき、後でAccept/Rejectを呼び出すイメージ）。1番目だとその場で決めなければならない。

@liaizon Okay, we're looking into it! Thanks!

We are designing an API to support manual accept/reject of follow requests in #BotKit. Which of the below two approaches seems better?

Returning true or false in the onFollow event

bot.onFollow = async (session, follower) => {
  // Accept follows requests from non-bot accounts:
  return follower instanceof Person;
};

Accepting a followRequest object as the third parameter in the onFollow event and calling the accept() or reject() method

bot.onFollow = async (session, follower, followRequest) => {
  // Accept follows requests from non-bot accounts:
  if (follower instanceof Person) await followRequest.accept();
  else await followRequest.reject();
};

@liaizon Oh, we haven't been aware that Pixelfed posts can have the location data! Could you provide any Pixelfed post that include the location data?

Starting with BotKit v0.1.0-dev.43+82e564fe, it allows your bot to follow and unfollow others!

ZennにBotKitの短いチュートリアルを投稿しました。BotKitやフェディバースのボット作りに興味の有る方は読んでみてください！

https://zenn.dev/hongminhee/articles/6e4c5ab155305f

짧게 BotKit 튜토리얼을 써 보았습니다. BotKit이나 聯合宇宙(연합우주) 봇 만들기에 關心(관심) 있으신 분들은 한 番(번)쯤 읽어보셔도 좋을 것 같습니다.

https://velog.io/@hongminhee/getting-started-with-botkit

Currently, #BotKit has only a handful of events—what else should we add?

botkit 로고 볼때마다 커엽네

Currently, #BotKit has only a handful of events—what else should we add?