palbert1/stella

Open-source legal workspace.

★ 0Forks 0GitHub ↗Compare

Project website ↗

README

Stella

Legal workspace: free to use, open to inspect, yours to keep.

Website · Manifesto · Issues · Contributing · Discord

Latest release License Stella Cloud Issues Discord


Stella is an open-source workspace for legal teams, currently in beta.

Features

Matters. Organize your practice around matters. Track status, deadlines, parties and related documents in one place.

Documents. Store, search and manage files across your organization. Full-text search, versioning and granular access control included.

Review. Analyze files at scale. Tabular Review pulls structured data from documents, built for due diligence, discovery and research.

Research. Find relevant laws, cases or doctrinal materials, with a database of legal sources, premium reading experience. Coming soon.

Anonymization. Remove personally identifiable information from documents and data before they are sent to AI. Coming soon.

Quickstart

stella Cloud

Hosted stella preview is available at my.stll.app.

Self-hosting

Run stella on your own infrastructure with the self-hosting guide. The self-host Compose file runs the API and Gotenberg only; configure Postgres, Redis or Valkey, S3-compatible storage, GOTENBERG_URL, and Gotenberg credentials in apps/api/.env.

Prerequisites

  • Bun
  • Git
  • Docker Desktop or Docker Engine

Run stella locally

git clone https://github.com/stella/stella.git
cd stella
bun run dev

This installs dependencies, prepares local env files, starts Docker services, pushes the database schema, starts the API at http://localhost:3001, starts the web app at http://localhost:3000, and opens the browser.

Optional demo data

bun --filter @stll/api db:seed-test-user
bun --filter @stll/api db:seed-dev

Common commands

# Run only the web app, reusing an existing API
bun run dev:web

# Run only the API and local infrastructure
bun run dev:api

# Run without opening a browser
bun run dev --no-browser

# Skip setup steps when iterating
bun run dev --skip-install
bun run dev --skip-db-push

# Use shifted ports for parallel worktrees
bun run dev --dev-instance feature-a

Local development uses mock AI by default. To use real AI, set provider keys in apps/api/.env and set USE_MOCK_AI="false".

Responsible use

Stella does not aim to replace human judgment or provide legal advice. Stella relies on AI models, which can produce incorrect or misleading output. We aim to ground AI flows in citations and traceable source material, but we encourage users to always validate the answers.

Contributing

We welcome contributions. You can help not only by writing code, but also, e.g., by providing feedback, or translating. Please read CONTRIBUTING.md for more information and our policy on AI-generated contributions.

PRs must pass the linting and testing pipeline. You will be prompted to sign the Contributor License Agreement (CLA) by CI.

Contact

  1. Open an issue for questions, feedback or suggestions.
  2. Reach out to us for general queries at [email protected].
  3. [email protected] for security issues (see Security Policy).

Licensing

Licensed under the AGPL v3. See LICENSE for details.

Development

Contributors

jan-kubicagithub-actions[bot]nnad3Nstella-lingo[bot]dependabot[bot]wzarekberticeekstella-provenance-updater[bot]DKolter

Issues