Home · Sign Up

Athera is an open source blogging social network similar to Medium, Dev and HashNode. Users can create an share content on the platform

Feature Roadmap

• More sources (a never ending pursuit)
• Article Recommendations
• AI Voiceovers
• PWA support

Tech Stack

• - Language
• - Framework
• - CSS
• - Database
• - Monorepo System
• - Package Manager
• - Deployment

Quick start

Before installing Athera, make sure your machine should have the following software installed:

• Docker
• NodeJS
• Supabase CLI
• Python 3.8+

Want to get up and running quickly? Follow these steps:

1. Fork this repository to your GitHub account.

After forking the repository, clone it to your local device by using the following command:

git clone https://github.com/<your-username>/athera

2. Run npm run db:start and copy the generated values into .env.example in the apps/web folder

   • This will spin up a postgres database and inbucket mailserver in a docker container.

3. Rename .env.example to .env.test

4. Run npm run dev:local in the root directory

Crawler Setup

1. Copy the values from npm run db:start and store them in .env.example renaming it to .env

2. Choose a suitable AI model for summarisation, popular choices include:

• Gemini 2.0 Flash Lite
• Gpt 4o-mini

The API url should be compatible with OpenAI's python libaries

Access Points for Your Application

1. App - http://localhost:3000

2. Incoming Mail Access - http://localhost:54324

3. Database Connection Details

   • Port: 54320
   • Connection: Use your favorite database client to connect using the provided port.

4. Supabase Dashboard - http://localhost:54323

License

This repository is available under the GNU Affero General Public License