Skip to content

angvit/Csphere

Repository files navigation

Csphere

Install Csphere on Chrome    Install Csphere on Firefox


Short for “content sphere”, Csphere.io is a bookmark management application and browser extension that allows users to easily save, search, and organize the web content they consume.

Features

  • Save different forms of web content (e.g. articles, blogs, documentation)
  • Add context via notes, descriptions, and custom keyword tags
  • Organize content using a custom folder structure managed through Csphere’s backend UI
  • Semantically search your content by meaning, time saved, or source
    (e.g. “Which articles have I read about jet engines this past month?”)
  • Cross-platform access across browsers and mobile devices

Local Setup Guide

Note: This project uses uv for Python dependency and virtual environment management. All Python commands below assume uv is installed and active.

1. Backend (Python + FastAPI)

cd backend
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
uvicorn app.api.main:app --reload

2. Frontend (Next.js)

cd frontend
npm install
npm run dev

3. Chrome Extension (Local)

  1. Open chrome://extensions
  2. Enable Developer Mode
  3. Click Load Unpacked
  4. Select the chrome_extension/ folder

Alembic Setup – Database Migrations

1. Install Alembic

uv pip install alembic

2. Initialize Alembic

alembic init

3. Configure alembic.ini

Set sqlalchemy.url to your PostgreSQL connection string.

4. Set Target Metadata

from app.db.base import Base
target_metadata = Base.metadata

5. Create a Migration

alembic revision --autogenerate -m "create users table"

6. Apply Migration

alembic upgrade head

Downgrade

alembic downgrade -1

Why Csphere?

The problem we identified is for someone who parses thousands of pages of web content daily and experiences trouble locating where this content was consumed, be it on a Chrome or Firefox browser. The user possibly has thousands of web pages already saved in their bookmarks folders and are looking for a more intelligent and context-rich search and storage over their content.

Install this if you are tired of having thousands of tabs open on your browser, debating if they should be saved with your important bookmarks or not. With Csphere you centralize and take control over the content you consume while organizing your desktop.

FAQ

How do I pronounce Csphere?

Csphere is pronounced as "see-sphere".

Can I start using Csphere now?

Visit Csphere.io and download the extension to start using Csphere.

Is Csphere free?

Yes, Csphere is 100% free to use.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors