Home

Awesome

<img alt="Spliit" height="60" src="https://github.com/spliit-app/spliit/blob/main/public/logo-with-text.png?raw=true" />

Spliit is a free and open source alternative to Splitwise. You can either use the official instance at Spliit.app, or deploy your own instance:

Deploy with Vercel

Features

Possible incoming features

Stack

Contribute

The project is open to contributions. Feel free to open an issue or even a pull-request!

If you want to contribute financially and help us keep the application free and without ads, you can also:

Run locally

  1. Clone the repository (or fork it if you intend to contribute)
  2. Start a PostgreSQL server. You can run ./scripts/start-local-db.sh if you don’t have a server already.
  3. Copy the file .env.example as .env
  4. Run npm install to install dependencies. This will also apply database migrations and update Prisma Client.
  5. Run npm run dev to start the development server

Run in a container

  1. Run npm run build-image to build the docker image from the Dockerfile
  2. Copy the file container.env.example as container.env
  3. Run npm run start-container to start the postgres and the spliit2 containers
  4. You can access the app by browsing to http://localhost:3000

Opt-in features

Expense documents

Spliit offers users to upload images (to an AWS S3 bucket) and attach them to expenses. To enable this feature:

NEXT_PUBLIC_ENABLE_EXPENSE_DOCUMENTS=true
S3_UPLOAD_KEY=AAAAAAAAAAAAAAAAAAAA
S3_UPLOAD_SECRET=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
S3_UPLOAD_BUCKET=name-of-s3-bucket
S3_UPLOAD_REGION=us-east-1

You can also use other S3 providers by providing a custom endpoint:

S3_UPLOAD_ENDPOINT=http://localhost:9000

Create expense from receipt

You can offer users to create expense by uploading a receipt. This feature relies on OpenAI GPT-4 with Vision and a public S3 storage endpoint.

To enable the feature:

NEXT_PUBLIC_ENABLE_RECEIPT_EXTRACT=true
OPENAI_API_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXX

Deduce category from title

You can offer users to automatically deduce the expense category from the title. Since this feature relies on a OpenAI subscription, follow the signup instructions above and configure the following environment variables:

NEXT_PUBLIC_ENABLE_CATEGORY_EXTRACT=true
OPENAI_API_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXX

License

MIT, see LICENSE.