15ea23d5d6
* feat: introduce hindsight-api-slim and hindsight-all-slim packages Closes #552 - Move all source code from hindsight-api/ to new hindsight-api-slim/ - hindsight-api-slim has heavy ML deps (torch, sentence-transformers, transformers, einops, flashrank, mlx, mlx-lm, safetensors) and pg0-embedded as optional extras: [local-ml], [embedded-db], [all] - hindsight-api becomes a zero-code meta-package depending on hindsight-api-slim[all] for full backward compatibility - Add hindsight-all-slim meta-package: hindsight-api-slim + client + embed - hindsight-all updated to depend on hindsight-api-slim[all] - pg0.py: lazy-import pg0 with clear ImportError pointing to [embedded-db] - Dockerfile: replace sed hack with proper uv sync --extra flags - Update release.yml, test.yml, lint.sh, release.sh, CLAUDE.md and all path references throughout the repo * refactor: rename hindsight/ directory to hindsight-all/ * docs: document hindsight-api-slim and hindsight-all-slim package variants Add package variants table and extras explanation to installation.md * docs: remove emojis from installation.md, use professional tone * docs: link Docker slim variant to pip package variants section * docs: consolidate Docker image variants into single table * ci: fix working-directory paths after package restructure - Replace all hindsight-api → hindsight-api-slim in test.yml - Replace hindsight → hindsight-all in test.yml - Add --extra embedded-db to test-embed API install step * ci: add local-ml and embedded-db extras to API sync steps These extras were previously implicit in the old hindsight-api package (which bundled everything). Now that hindsight-api-slim uses optional extras, we must explicitly request local-ml and embedded-db in CI. * ci: add API install step with embedded-db to test-embed smoke test The smoke test starts hindsight-api as a daemon, which requires pg0-embedded. Add a dedicated install step for hindsight-api-slim with embedded-db extra so the daemon can start successfully. * ci: remove --no-install-project when using optional extras When --no-install-project is combined with --extra, the optional deps are not installed because extras require the project to be active. Remove --no-install-project from steps that need local-ml or embedded-db. * ci: fix ordering of uv sync steps to preserve optional extras When uv sync runs for a different workspace member, it removes optional extras installed for other members. Fix by always running extra-requiring API sync last, after other workspace member syncs. Also remove --no-install-project from embedded-db sync in test-embed, as --no-install-project prevents optional extras from being active. * ci: add local-ml extra to test-embed API install for smoke test The smoke test starts the full API server which needs sentence-transformers for local embeddings (default provider). Add local-ml extra to the install. * ci: simplify extras with --all-extras and add slim pip smoke test - Replace explicit --extra local-ml --extra embedded-db with --all-extras for cleaner, more maintainable sync steps - Add test-pip-slim job: tests hindsight-api-slim[embedded-db] without local ML models, using Cohere for embeddings/reranking (mirrors Docker slim smoke test approach) * ci: simplify slim smoke test to health check only (mirrors Docker test)
105 lines
4.9 KiB
Python
105 lines
4.9 KiB
Python
"""
|
|
Banner display for Hindsight API startup.
|
|
|
|
Shows the logo and tagline with gradient colors.
|
|
"""
|
|
|
|
from .utils import mask_network_location
|
|
|
|
# Gradient colors: #0074d9 -> #009296
|
|
GRADIENT_START = (0, 116, 217) # #0074d9
|
|
GRADIENT_END = (0, 146, 150) # #009296
|
|
|
|
# Pre-generated logo (generated by test-logo.py)
|
|
LOGO = """\
|
|
\033[38;2;9;127;184m\u2584\033[0m\033[48;2;8;130;178m\033[38;2;5;133;186m\u2584\033[0m \033[48;2;10;143;160m\033[38;2;10;143;165m\u2584\033[0m\033[38;2;7;140;156m\u2584\033[0m
|
|
\033[38;2;8;125;192m\u2584\033[0m \033[38;2;3;132;191m\u2580\033[0m\033[38;2;2;133;192m\u2584\033[0m \033[38;2;3;132;180m\u2584\033[0m\033[38;2;1;137;184m\u2584\033[0m\033[38;2;3;133;174m\u2584\033[0m \033[38;2;3;142;176m\u2584\033[0m\033[38;2;4;142;169m\u2580\033[0m \033[38;2;10;144;164m\u2584\033[0m
|
|
\033[38;2;6;121;195m\u2580\033[0m\033[38;2;5;128;203m\u2580\033[0m\033[48;2;5;124;195m\033[38;2;3;125;200m\u2584\033[0m\033[38;2;2;126;196m\u2584\033[0m\033[48;2;3;128;188m\033[38;2;1;131;196m\u2584\033[0m\033[48;2;0;152;219m\033[38;2;2;131;191m\u2584\033[0m\033[38;2;1;141;196m\u2580\033[0m\033[38;2;1;135;183m\u2580\033[0m\033[38;2;1;148;198m\u2580\033[0m\033[48;2;1;156;202m\033[38;2;2;135;180m\u2584\033[0m\033[48;2;4;134;169m\033[38;2;1;137;177m\u2584\033[0m\033[38;2;3;138;173m\u2584\033[0m\033[48;2;6;137;165m\033[38;2;2;140;170m\u2584\033[0m\033[38;2;7;144;169m\u2580\033[0m\033[38;2;7;139;158m\u2580\033[0m
|
|
\033[48;2;2;128;202m\033[38;2;2;124;201m\u2584\033[0m\033[48;2;1;130;201m\033[38;2;0;135;212m\u2584\033[0m\033[38;2;2;128;196m\u2584\033[0m \033[48;2;2;142;204m\033[38;2;7;138;199m\u2584\033[0m \033[38;2;1;135;186m\u2584\033[0m\033[48;2;1;142;186m\033[38;2;2;144;194m\u2584\033[0m\033[48;2;3;138;176m\033[38;2;2;134;176m\u2584\033[0m
|
|
\033[48;2;8;118;200m\033[38;2;8;121;209m\u2584\033[0m\033[38;2;3;121;203m\u2580\033[0m \033[38;2;3;122;192m\u2580\033[0m\033[38;2;1;138;216m\u2580\033[0m\033[48;2;0;138;210m\033[38;2;3;128;198m\u2584\033[0m\033[48;2;0;126;188m\033[38;2;2;131;198m\u2584\033[0m\033[48;2;0;142;205m\033[38;2;3;132;193m\u2584\033[0m\033[38;2;1;140;196m\u2580\033[0m \033[38;2;4;134;175m\u2580\033[0m\033[48;2;13;135;167m\033[38;2;8;136;174m\u2584\033[0m """
|
|
|
|
|
|
def _interpolate_color(start: tuple, end: tuple, t: float) -> tuple:
|
|
"""Interpolate between two RGB colors."""
|
|
return (
|
|
int(start[0] + (end[0] - start[0]) * t),
|
|
int(start[1] + (end[1] - start[1]) * t),
|
|
int(start[2] + (end[2] - start[2]) * t),
|
|
)
|
|
|
|
|
|
def gradient_text(text: str, start: tuple = GRADIENT_START, end: tuple = GRADIENT_END) -> str:
|
|
"""Render text with a gradient color effect."""
|
|
result = []
|
|
length = len(text)
|
|
for i, char in enumerate(text):
|
|
if char == " ":
|
|
result.append(" ")
|
|
else:
|
|
t = i / max(length - 1, 1)
|
|
r, g, b = _interpolate_color(start, end, t)
|
|
result.append(f"\033[38;2;{r};{g};{b}m{char}")
|
|
result.append("\033[0m")
|
|
return "".join(result)
|
|
|
|
|
|
def print_banner():
|
|
"""Print the Hindsight startup banner."""
|
|
print(LOGO)
|
|
tagline = gradient_text("Hindsight: Agent Memory That Works Like Human Memory")
|
|
print(f"\n {tagline}\n")
|
|
|
|
|
|
def color(text: str, t: float = 0.0) -> str:
|
|
"""Color text using gradient position (0.0 = start, 1.0 = end)."""
|
|
r, g, b = _interpolate_color(GRADIENT_START, GRADIENT_END, t)
|
|
return f"\033[38;2;{r};{g};{b}m{text}\033[0m"
|
|
|
|
|
|
def color_start(text: str) -> str:
|
|
"""Color text with gradient start color (#0074d9)."""
|
|
return color(text, 0.0)
|
|
|
|
|
|
def color_end(text: str) -> str:
|
|
"""Color text with gradient end color (#009296)."""
|
|
return color(text, 1.0)
|
|
|
|
|
|
def color_mid(text: str) -> str:
|
|
"""Color text with gradient middle color."""
|
|
return color(text, 0.5)
|
|
|
|
|
|
def dim(text: str) -> str:
|
|
"""Dim/gray text."""
|
|
return f"\033[38;2;128;128;128m{text}\033[0m"
|
|
|
|
|
|
def print_startup_info(
|
|
host: str,
|
|
port: int,
|
|
database_url: str,
|
|
llm_provider: str,
|
|
llm_model: str,
|
|
embeddings_provider: str,
|
|
reranker_provider: str,
|
|
mcp_enabled: bool = False,
|
|
version: str | None = None,
|
|
vector_extension: str | None = None,
|
|
text_search_extension: str | None = None,
|
|
):
|
|
"""Print styled startup information."""
|
|
print(color_start("Starting Hindsight API..."))
|
|
if version:
|
|
print(f" {dim('Version:')} {color(f'v{version}', 0.1)}")
|
|
print(f" {dim('URL:')} {color(f'http://{host}:{port}', 0.2)}")
|
|
print(f" {dim('Database:')} {color(mask_network_location(database_url), 0.4)}")
|
|
print(f" {dim('LLM:')} {color(f'{llm_provider} / {llm_model}', 0.6)}")
|
|
print(f" {dim('Embeddings:')} {color(embeddings_provider, 0.8)}")
|
|
print(f" {dim('Reranker:')} {color(reranker_provider, 1.0)}")
|
|
extensions = f"{vector_extension or 'default'} (vector) / {text_search_extension or 'default'} (text)"
|
|
print(f" {dim('Extensions:')} {color(extensions, 0.4)}")
|
|
if mcp_enabled:
|
|
print(f" {dim('MCP:')} {color_end('enabled at /mcp')}")
|
|
print()
|