Neta is a comprehensive, self-hosted workspace designed specifically for freelancers. It serves as a centralized operating system to manage daily operations, clients, projects, finances, and personal performance tracking.

Built with a focus on simplicity, security, and edge-to-edge aesthetic design, Neta allows a single user (the freelancer) to operate their entire business from one dashboard without relying on multiple third-party SaaS subscriptions.

Features and Modules

1. Unified Dashboard

A command center providing a tactical overview of your current performance. It tracks active revenue, task completion, and upcoming deadlines, ensuring you always know what needs immediate attention.

2. Client Management

A structured CRM to manage your client base. You can track client statuses, store communication notes, and link clients directly to ongoing projects and tasks.

3. Project and Task Management

A robust pipeline for tracking project milestones and individual tasks. Features include priority assignments, status tracking, deadline management, and automated project progress calculations.

4. Financial Tracking

An integrated ledger to monitor income, expenses, and cash flow. It provides graphical analysis and clear tabular data of your recent transactions, allowing you to stay on top of your financial health.

5. Journal and Performance Analytics

A dedicated journaling module to record daily mood, energy levels, and work satisfaction. This data is aggregated to provide trend analysis, helping you understand how your personal well-being correlates with your professional output.

6. Built-in AI Assistant

A localized AI module integrated directly into your workspace. It connects to your choice of provider (Google Gemini, OpenAI, Groq, or local Ollama instances) and can query your existing database to provide instant summaries, insights, and answers regarding your tasks and finances.

7. Client Portal

A restricted, read-only interface that you can share with your clients. They can log in to view the progress of their specific projects and public tasks, providing transparency without compromising your internal data security.

Technical Architecture

Neta is engineered using modern, high-performance web technologies:

Frontend: Next.js (App Router) combined with React Server Components.
Styling: Tailwind CSS with a custom, bespoke design system via Poyraz UI.
Backend and Database: Supabase (PostgreSQL) handling authentication, Row Level Security (RLS), and database migrations.
AI Integration: Vercel AI SDK for streaming responses and tool-calling capabilities.
Deployment: Fully containerized with Docker, optimized for standalone builds.

Installation and Deployment

Neta is designed for self-hosting. The current Docker Compose file runs the Neta web application and connects it to a Supabase-compatible backend. A bundled Supabase Compose profile is planned for the full-stack self-host mode.

Prerequisites

Docker and Docker Compose
A Supabase project or self-hosted Supabase backend
Supabase API URL, anon key, and service role key
A direct Postgres DATABASE_URL if you want the installer to apply migrations automatically

1-Click Installation (Recommended)

You can install Neta using the interactive setup script:

curl -sL https://raw.githubusercontent.com/poyrazavsever/neta/main/install.sh | bash

The installer asks for the required Supabase values, writes a .env file, optionally applies database migrations, validates Docker Compose configuration, and starts the application.

Manual Installation

If you prefer to set up Neta manually:

Clone the repository: git clone https://github.com/poyrazavsever/neta.git
Navigate to the directory and copy the .env.example file to .env.
Fill every required value in .env.
Apply database migrations:

DATABASE_URL='postgresql://postgres:password@host:5432/postgres' bash ./scripts/apply-migrations.sh

Build and start the Docker container:

docker compose up -d --build

Docker Compose intentionally fails fast when required Supabase environment values are missing.

First Administrator Account

To ensure data security, Neta is locked to a single administrator. Upon launching the application for the first time, navigate to the /register route to create the initial admin account. Once this account is created, public registration is permanently disabled.

License

This project is proprietary and intended for personal self-hosting.