https://github.com/dimensiondev/flare
The ultimate next generation open-sourced AI powered decentralized social network client.
https://github.com/dimensiondev/flare
Last synced: 14 days ago
JSON representation
The ultimate next generation open-sourced AI powered decentralized social network client.
- Host: GitHub
- URL: https://github.com/dimensiondev/flare
- Owner: DimensionDev
- License: agpl-3.0
- Created: 2023-07-19T10:11:19.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-04-09T11:13:57.000Z (10 months ago)
- Last Synced: 2025-04-09T16:06:27.845Z (10 months ago)
- Language: Kotlin
- Homepage: https://flareapp.moe/
- Size: 34.4 MB
- Stars: 126
- Watchers: 10
- Forks: 9
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Flare
[](https://github.com/DimensionDev/Flare/blob/master/LICENSE)
[](https://crowdin.com/project/flareapp)
[](https://deepwiki.com/DimensionDev/Flare)
[](https://t.me/+0UtcP6_qcDoyOWE1)
[](https://discord.gg/De9NhXBryT)




Flare is an open-source social client that merges your feeds from Mastodon, Misskey, Bluesky, X, and RSS into a single timeline, turning it into your personal information hub, with Android/iOS and macOS/Windows Support.
## Features
- Consolidate all your social networks into one client, featuring Mastodon, Misskey, Bluesky and more to come.
- Crosspost your content simultaneously across all your platforms.
- It is FOSS and privacy-centric.
## Roadmap
Here're some features we're planning to implement in the future.
- [ ] Grouped Mixed timeline
- [ ] Showing instance's announcement
- [ ] Crossposting for repost
- [ ] Auto thread
- [ ] AI powered features
- [ ] Personal trends of the day
- [ ] Quick reply
- [ ] Support for Meta Threads
- [ ] Support for Discourse forum
- [x] Desktop Client
- [ ] Web Client(?)
Here're some features we've done before.
- [x] Mixed timeline
- [x] AI powered features
- [x] Translation
- [x] Summary
- [x] Anonymous mode enhancement, option to change data source
- [x] Local history
- [x] RSS feed support
- [x] Support for vvo platform
- [x] Anonymous mode, no need to login
- [x] Customizable tabs
- [x] Local filtering
- [x] Crossposting
- [x] Translation
### Mastodon
- [x] Support for polls
- [x] Support global/local timelines
- [x] Support for lists
- [x] Support for bookmarks/faovrites timelines
### Misskey
- [x] Support for polls
- [x] Support for lists
- [x] Support for antennas
- [x] Support for faovrites timeline
### Bluesky
- [x] Support for lists
- [x] Support for feeds
- [x] Support DM
## Building
### Android
- Make sure you have JDK 21 installed
- Run `./gradlew installDebug` to build and install the debug version of the app
- You can open the project in Android Studio or IntelliJ IDEA if you want
### iOS
- Make sure you have a Mac with Xcode 26 installed
- open `iosApp/Flare.xcodeproj` in Xcode
- Build and run the app
### Server
- Flare Server uses Ktor with Kotlin Native, which only works on Linux X64 and MacOS X64/ARM64
- Make sure you have JDK 21 installed
- Run `./gradlew :server:runDebugExecutableMacosArm64 -PrunArgs="--config-path=path/to/server/src/commonMain/resources/application.yaml"` to build and run the server, remember to replace `path/to/server/src/commonMain/resources/application.yaml` with the path to your config file
- The server will run on `http://localhost:8080` by default
#### Docker
If you prefer using Docker, you can use Docker Compose to run prebuild Server Image.
- Rename `.env.sample` to `.env`, and update the environment variables in the file.
- If you're deploying into a production server, you might need to update the `docker-compose.yml` file with these lines:
```diff
environment:
- # STAGE: local
+ STAGE: 'production'
- DOMAINS: api.flareapp.moe -> http://flare-backend:8080
+ DOMAINS: your_domain_here -> http://flare-backend:8080
```
- Run `docker compose up -d`
### Desktop
- Make sure you have JDK 21 installed, JBR-21 is recommended.
#### macOS
- Make sure you have Xcode 26 installed
- Run `./gradlew run` to build and run the debug version of the desktop app.
#### Windows
- Make sure you have Visual Studio 2022 installed with Windows App development installed
- Open `desktopApp/src/main/csharp/Flare.csproj` with Visual Studio
- Click Run and you should able to build and run the app.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.
## License
This project is licensed under the [AGPL-3.0](LICENSE) license.
