Skip to content

RoJLD/Anthropos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Anthropos

Manage your career. Architect your life.


Python 3.13 FastAPI Tests License: MIT

Career Life API Endpoints Multi-tenant


A local-first platform to pilot your job search and design your personal life — privacy-first, API-driven, fully yours.


Overview

Anthropos (from Greek anthropos — "human") is a local-first platform built on FastAPI, organized around two pillars:

  • Career — End-to-end job search management: applications tracking, contact CRM, interview preparation, automated follow-ups, portfolio management.
  • Life — Personal life architecture: health tracking, mental wellness, personal projects, and time management.

Both share a robust infrastructure with tenant isolation, API versioning, and a tier-based access system.


Architecture

graph TB
    subgraph Client["Client Layer"]
        Browser["Browser / Swagger UI"]
        Bot["Telegram Bot"]
        CLI["CLI / Scripts"]
    end

    subgraph Gateway["API Gateway"]
        direction LR
        MW_Tier["Tier Gate\nMiddleware"]
        MW_Tenant["Tenant\nIsolation"]
        V1["API v1\nRouter"]
    end

    subgraph Career["Career — 17 modules"]
        direction LR
        C_Free["candidatures\ncontacts\ndashboard\nentretien\ninterview\ngenerator\nportfolio\nsearch"]
        C_Free2["email_sender\nrelance_rss\nquick_add\ntelegram\nweekly_digest\nbackup\nhealth_check\nconfig\nerror_log"]
    end

    subgraph Life["Life — 4 modules"]
        direction LR
        L_Free["sante\nmental\nprojets\ntemps"]
    end

    subgraph Shared["Shared Infrastructure"]
        Tenant["Tenant Store\n(data isolation)"]
        Tiers["Tier Registry\n(free/pro/elite)"]
        Storage["Storage Abstraction\n(in-memory / future DB)"]
    end

    Browser --> Gateway
    Bot --> Gateway
    CLI --> Gateway
    MW_Tier --> MW_Tenant --> V1
    V1 --> Career
    V1 --> Life
    Career --> Shared
    Life --> Shared

    style Gateway fill:#1e293b,stroke:#334155,color:#f8fafc
    style Career fill:#1e3a5f,stroke:#2563eb,color:#f8fafc
    style Life fill:#3b1f6e,stroke:#8b5cf6,color:#f8fafc
    style Shared fill:#14532d,stroke:#22c55e,color:#f8fafc
    style Client fill:#292524,stroke:#78716c,color:#f8fafc
Loading

Features

Career

Module Description Endpoints
candidatures Track applications, statuses, batch operations 6
contacts Professional CRM — import/export CSV, search 5
dashboard Central overview with KPIs and pipeline stats 3
entretien Interview tracking and follow-up management 5
interview Interview session preparation and notes 4
generator Cover letter and CV generation 3
portfolio Professional portfolio management 4
search Job offer search and aggregation 3
email_sender SMTP-based application emails 3
relance_rss Automated follow-up via RSS feeds 3
quick_add Paste a JD, auto-extract and create contact 2
telegram Telegram bot notifications 3
weekly_digest Weekly summary of pipeline activity 2
backup Data backup and restore 3
health_check System health verification 1
config_router User configuration management 3
error_log Error journal and diagnostics 2

Life

Module Code Description Endpoints
sante L1 Physical health, sleep, exercise tracking 8
mental L2 Journaling, stress management, mindfulness 8
projets L7 Side projects, hobbies, volunteering 8
temps L8 Routines, priorities, agenda management 8

Quick Start

Prerequisites

  • Python 3.11+
  • pip

Installation

# Clone
git clone https://github.com/RoJLD/anthropos.git
cd anthropos

# Virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate    # Linux/Mac
.venv\Scripts\activate       # Windows

# Dependencies
pip install -r requirements.txt

Launch

# Career → http://localhost:8000/docs
cd satellites/anthropos/apps/career
uvicorn admin:app --reload --port 8000

# Life → http://localhost:8001/docs
cd satellites/anthropos/apps/life
uvicorn main:app --reload --port 8001

Verify

# Health checks
curl http://localhost:8000/health
curl http://localhost:8001/health

API

Both applications expose a RESTful API with interactive documentation:

App Swagger UI ReDoc Base URL
Career localhost:8000/docs localhost:8000/redoc /v1/
Life localhost:8001/docs localhost:8001/redoc /v1/

All routes are available under /v1/ (recommended) and without prefix (backward compatibility).

Example Request

# Add a new job application
curl -X POST http://localhost:8000/v1/candidatures/ \
  -H "Content-Type: application/json" \
  -d '{
    "company": "Anthropic",
    "position": "ML Engineer",
    "status": "applied",
    "date": "2026-04-03"
  }'

# Log a health entry
curl -X POST http://localhost:8001/v1/sante/logs \
  -H "Content-Type: application/json" \
  -d '{
    "type": "exercise",
    "duration_min": 45,
    "notes": "Morning run"
  }'

Project Structure

satellites/
  anthropos/
    apps/
      career/                 # Career
        routers/              #   17 free modules
        core/                 #   Business logic
        templates/            #   HTML templates
        tests/                #   Unit tests
      life/                   # Life
        extensions/           #   4 free modules
        tests/                #   Unit tests
    shared/                   # Shared infrastructure
      tenant.py               #   Multi-tenant data isolation
      tiers.py                #   Tier-based access control
bridge/                       # Inter-satellite communication
tests/                        # E2E, contract, smoke, perf tests
scripts/                      # Utilities and CI scripts

Testing

# All tests
python -m pytest satellites/anthropos/ -v

# Career only
python -m pytest satellites/anthropos/apps/career/tests/ -v

# Life only
python -m pytest satellites/anthropos/apps/life/tests/ -v

# With coverage
python -m pytest satellites/anthropos/ --cov=satellites/anthropos -v

Tier System

This repository contains the free tier. Advanced capabilities are available in Pro and Elite tiers:

Free                          Pro                           Elite
 Career: 17 modules            + analytics                   + autonomous agents
 Life: 4 modules               + scoring, network            + flywheel, deploy
 (this repo)                   + finances, relations         + administratif, legacy
                               + 6 more life modules         + MCP integration

Tech Stack

Layer Technology
Runtime Python 3.13
Framework FastAPI 0.115 + Uvicorn
Validation Pydantic v2
Testing pytest + httpx
Architecture Multi-tenant, API versioned, storage-abstracted

Contributing

Contributions are welcome. Please open an issue first to discuss what you would like to change.

License

MIT


Built with precision by RoJLD

About

Anthropos — Manage your career . Architect your life. Local-first API platform built on FASTAPI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors