https://github.com/imigueldiaz/bluesky-aroace-feed
Multilingual Bluesky feed generator for ace/aro community content with smart filtering and language support for EN, ES, FR, DE.
https://github.com/imigueldiaz/bluesky-aroace-feed
aromantic asexuality atproto atprotocol bluesky bluesky-feed feed-generator javascript lgbtqia natural-language-processing nlp node social-network typescript
Last synced: 7 months ago
JSON representation
Multilingual Bluesky feed generator for ace/aro community content with smart filtering and language support for EN, ES, FR, DE.
- Host: GitHub
- URL: https://github.com/imigueldiaz/bluesky-aroace-feed
- Owner: imigueldiaz
- License: mit
- Created: 2024-12-07T08:11:41.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-04T08:42:42.000Z (8 months ago)
- Last Synced: 2025-03-04T09:34:01.276Z (8 months ago)
- Topics: aromantic, asexuality, atproto, atprotocol, bluesky, bluesky-feed, feed-generator, javascript, lgbtqia, natural-language-processing, nlp, node, social-network, typescript
- Language: JavaScript
- Homepage:
- Size: 472 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Bluesky Aroace Feed 🌈
[](https://opensource.org/licenses/MIT)
[](https://github.com/imigu/bluesky-aroace-feed/graphs/commit-activity)
> [!CAUTION]
> The test files in this project contain examples of hate speech, discriminatory language, and other potentially triggering content that are used to validate the content filtering system. These examples are necessary for testing purposes but may be distressing to read. Please exercise caution when reviewing the test files.
A specialized feed generator for the Bluesky social network that curates content related to the aromantic and asexual (aroace) community. This project aims to create a safe and inclusive space for aroace individuals to connect and share their experiences.
## 🌟 Features
- Multi-language support (English, Spanish, French, German)
- Context-aware content filtering:
- Detects and includes positive discussions about ace/aro identity
- Filters out gaming-related "ace" mentions
- Handles mixed contexts appropriately
- Advanced language detection using NLP (Natural Language Processing)
- Spam and commercial content filtering
- Hate speech and negative content detection
- Support for Bluesky's native language tags
- Curated feed of aroace-related content on Bluesky
- Custom filtering and content moderation
- Real-time feed updates
- Community-driven content discovery
## 🚀 Getting Started
### Prerequisites
- Node.js 22.0.0 or higher
- A Bluesky account
- API credentials for Bluesky
### Installation
1. Clone the repository
```bash
git clone https://github.com/imigu/bluesky-aroace-feed.git
cd bluesky-aroace-feed
```
2. Install dependencies
```bash
npm install
```
3. Configure your environment variables
```bash
cp .env.example .env
# Edit .env with your Bluesky credentials
```
## 🔧 Configuration
1. Create a `.env` file with your Bluesky credentials:
```env
BSKY_HANDLE=your-handle.bsky.social
BSKY_APP_PASSWORD=your-app-password
```
2. Configure the feed settings in `config.js` if needed
## 🚀 Running the Feed
Start the feed generator:
```bash
npm start
```
For development with auto-reload:
```bash
npm run dev
```
## 🧪 Testing
Run the test suite:
```bash
npm test
```
For test coverage:
```bash
npm run test:coverage
```
Note: The test suite contains examples of hate speech and discriminatory language used to validate the content filtering system. These examples are necessary for testing purposes but may be distressing to read.
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 🙏 Acknowledgments
Special thanks to:
- [Compromise](https://github.com/spencermountain/compromise) (@spencermountain) for their incredible NLP library that powers our language detection and text analysis
- The Bluesky team for their open protocol and support
- The aroace community for their feedback and support
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 📞 Contact
Project Link: [https://github.com/imigu/bluesky-aroace-feed](https://github.com/imigu/bluesky-aroace-feed)
---
Made with ❤️ for the aroace community