Dhoni77 / isaac

The AI-native, open source research workspace. Accelerating science.

README.md is a work-in-progress. Please check back later for more updates.

Isaac

The AI-native, open source research workspace. Accelerating science.

Description

You've stumbled upon the most exciting thing since sliced bread in the world of research and AI. But guess what? Our README is playing catch up with our awesomeness. It's still a work-in-progress, just like the best of us.

We're on a mission to make Isaac the go-to tool for researchers, scientists, and knowledge workers - basically anyone who loves to blend coffee with groundbreaking ideas.

Prerequisites

• Python 3.x
• Supabase Account

Installation Steps

1. Fork the repo from here

2. Clone the forked repo to your local machine

git clone https://github.com/aietal/isaac.git

Setting up the API

Step 1: Go to api directory

cd api

Step 2: Create and activate Python virtual environment

For Mac/Linux:

python3 -m venv env
source env/bin/activate

For Windows:

py -m venv env
.\env\Scripts\activate

Step 3: Install dependencies

pip3 install --no-cache-dir -r requirements.txt "unstructured[all-docs]==0.10.10" "psycopg2-binary"

Step 4: Run api

OPENAI_API_KEY=sk-... python3 -m uvicorn app.main:app --host 0.0.0.0 --port 5001 --reload

Setting up the web app

Setting up Supabase

Step 1: Set Up Your Supabase Account

To use Isaac, you first need a Supabase account. If you don't have one, sign up at Supabase. After signing up, create a new project in your Supabase account.

Step 2: Create Database Schema

Once your project is set up, you'll need to create a specific database schema for Isaac to work correctly. To do this, go to the SQL editor in your Supabase project and run the following scripts:

create table projects ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now(), title text, updated_at timestamp default now(), userId uuid, description text, emoji text, sortingOrder smallint );

create table chat_sessions ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now() not null, title text not null, updated_at timestamp default now(), type text not null, project_id uuid references projects (id) );

create table documents ( created_at timestamp default now(), text json, type text, userId text, title text not null, id uuid default uuid_generate_v4() primary key, projectId uuid, updated_at timestamp default now() );

create table isaac_messages ( id bigint not null primary key, created_at timestamp default now(), userId uuid, projectId uuid, type character, content jsonb, updated_at timestamp default now() );

create table profile ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now(), is_subscribed boolean, interval text, stripe_customer text, email text, first_name text, last_name text, plan text, has_seen_tour boolean, expiration_date date default now(), updated_at timestamp default now(), has_seen_latest_update boolean, daily_free_token smallint, has_seen_community_banner boolean not null, custom_instructions jsonb, editor_language text not null );

create table notes ( id uuid default uuid_generate_v4() primary key, projectId uuid references projects (id), text json, created_at timestamp default now(), updated_at timestamp default now() );

create table "references" ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now(), title text, authors json, year text, doi text, projectId uuid default uuid_generate_v4(), tldr text, pdf text, updated_at timestamp default now(), type text, source text, sourceId text, url text, abstract text );

create table comments ( id uuid default uuid_generate_v4() primary key, quote text, type text, comments json[], documentId text, created_at timestamp default now() not null, updated_at timestamp default now() );

create table uploads ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now(), user_id uuid default uuid_generate_v4(), status public.upload_processing_status not null, citation jsonb, project_id uuid references projects (id), file_name text, custom_citation jsonb, updated_at timestamp default now(), type text, abstract text, tldr text );

create table chat_messages ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now() not null, content text, session_id uuid references chat_sessions (id), metadata jsonb, role text not null, note_id uuid references notes (id) );

create table document_embeddings ( id bigint not null primary key, content text, metadata jsonb, embedding extensions.vector(1536), upload_id uuid references uploads (id), searchable_content tsvector, updated_at timestamp default now() );

create table user_integrations ( id uuid default uuid_generate_v4() primary key, created_at timestamp default now() not null, zotero jsonb, mendeley jsonb );

Runing the web app

1. Go to web directory

cd web

2. Create .env file

Please refer to the .env.example in the /web directory.

2. Install dependencies

npm install

3. Run the app

npm run dev

Contributing to Isaac

First off, thanks for taking the time to contribute! ❤️

All types of contributions are encouraged and valued. Please read our Code of Conduct to get started.

Community

Join our Discord Community, if you're interested to make your mark in the annals of research tool history or not.

License

Isaac is open-source under GNU Affero General Public License Version 3 (AGPLv3)

---