kubera-core 0.1.1__tar.gz

kubera_core-0.1.1/.env.example

@@ -0,0 +1,2 @@
+KUBERA_SECRET_TOKEN=
+KUBERA_DATABASE_URL=sqlite:///kubera.db

kubera_core-0.1.1/.github/ISSUE_TEMPLATE/api_request.yml

@@ -0,0 +1,46 @@
+name: API Request
+description: Request a new or modified API endpoint
+labels: ["api-request"]
+body:
+  - type: input
+    id: endpoint
+    attributes:
+      label: Requested endpoint
+      description: The endpoint being requested
+      placeholder: "GET /api/v1/..."
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What this endpoint should do
+    validations:
+      required: true
+  - type: textarea
+    id: schema
+    attributes:
+      label: Request / Response schema
+      description: Expected request and response format
+      placeholder: |
+        Request:
+          POST /api/v1/users { "name": "string", "email": "string" }
+        Response:
+          201 { "id": "number", "name": "string", "email": "string" }
+    validations:
+      required: true
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use case
+      description: Why is this endpoint needed?
+    validations:
+      required: true
+  - type: input
+    id: origin-issue
+    attributes:
+      label: Origin issue
+      description: The issue that triggered this request
+      placeholder: "oh-my-kubera/kubera-web#123"
+    validations:
+      required: false

kubera_core-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,36 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened? Include error messages if any.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What you expected to happen
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What actually happened
+    validations:
+      required: true

kubera_core-0.1.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

kubera_core-0.1.1/.github/ISSUE_TEMPLATE/enhancement.yml

@@ -0,0 +1,18 @@
+name: Enhancement
+description: Suggest an improvement or new feature
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the enhancement
+    validations:
+      required: true
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation / use case
+      description: Why is this enhancement needed? What problem does it solve?
+    validations:
+      required: true

kubera_core-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - run: uv build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

kubera_core-0.1.1/.github/workflows/sync-spec.yml

@@ -0,0 +1,54 @@
+name: Sync OpenAPI spec to kubera-web
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "src/kubera/api/**"
+      - "scripts/export_openapi.py"
+
+jobs:
+  sync-spec:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e .
+
+      - name: Export openapi.json
+        run: python scripts/export_openapi.py
+
+      - name: Checkout kubera-web
+        uses: actions/checkout@v4
+        with:
+          repository: oh-my-kubera/kubera-web
+          token: ${{ secrets.KUBERA_ORG_PAT }}
+          ref: develop
+          path: kubera-web
+
+      - name: Check for changes
+        id: diff
+        run: |
+          mkdir -p kubera-web/specs
+          diff -q openapi.json kubera-web/specs/core-openapi.json && echo "changed=false" >> $GITHUB_OUTPUT || echo "changed=true" >> $GITHUB_OUTPUT
+
+      - name: Update spec
+        if: steps.diff.outputs.changed == 'true'
+        run: cp openapi.json kubera-web/specs/core-openapi.json
+
+      - name: Create PR
+        if: steps.diff.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@v7
+        with:
+          token: ${{ secrets.KUBERA_ORG_PAT }}
+          path: kubera-web
+          base: develop
+          branch: chore/update-core-spec
+          title: "chore: update core openapi.json"
+          body: "Auto-generated from kubera-core ${{ github.sha }}"
+          commit-message: "chore: update core openapi.json"

kubera_core-0.1.1/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+
+# Virtual environment
+.venv/
+
+# Database
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Environment
+.env
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# OMC
+.omc/
+
+# Claude Code
+.claude/
+
+# Coverage
+htmlcov/
+.coverage
+.coverage.*

kubera_core-0.1.1/CLAUDE.md

@@ -0,0 +1,24 @@
+# kubera-core
+
+## API Contract First
+- When adding or changing API endpoints, **define schemas first** before implementation
+- Order: schema design → export openapi.json → create kubera-web issue → implement
+- Finalize and share response schemas early so web can develop in parallel
+- Schemas must clearly specify all fields, types, nullable, and nested structures
+
+## Security
+- Credential keys: CLI only for input/viewing. API returns status only.
+
+## Deployment Constraints
+- Runs on user's PC (self-hosted) — not a managed server
+- Must work cross-platform: Windows, macOS, Linux
+- Zero-config ideal: `pip install kubera-core && kubera-core start`
+- SQLite default — no external services required
+- Keep dependencies minimal and cross-platform compatible
+
+## Build & Test
+- Package manager: `uv`
+- Run tests: `uv run pytest`
+- Run single test: `uv run pytest tests/test_xxx.py`
+- Export OpenAPI: `uv run python scripts/export_openapi.py`
+- Dev server: `uv run kubera-core start`

kubera_core-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SanGyuk-Raccoon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kubera_core-0.1.1/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: kubera-core
+Version: 0.1.1
+Summary: Personal asset management backend
+Project-URL: Homepage, https://github.com/oh-my-kubera/kubera-core
+Project-URL: Repository, https://github.com/oh-my-kubera/kubera-core
+Project-URL: Issues, https://github.com/oh-my-kubera/kubera-core/issues
+Author-email: SanGyuk-Raccoon <dmstjkim80@gmail.com>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: alembic>=1.13.0
+Requires-Dist: cryptography>=43.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: uvicorn[standard]>=0.30.0
+Description-Content-Type: text/markdown
+
+# Kubera Core
+
+Personal asset management backend. All financial data stays on your machine.
+
+## Install & Run
+
+```bash
+pip install kubera-core
+kubera-core start
+```
+
+- API docs: http://localhost:8000/docs
+- Auth token is auto-generated and printed on first start
+
+## Options
+
+```bash
+kubera-core start --host 127.0.0.1 --port 3000
+kubera-core token                    # show current token
+kubera-core token --refresh          # generate new token
+```
+
+## Credential Management
+
+API keys for financial services are managed via CLI only (never through web).
+
+```bash
+kubera-core credential add upbit     # interactive masked input
+kubera-core credential list          # show status
+kubera-core credential remove upbit
+```
+
+Supported providers: upbit, kis, binance, codef
+
+## Tech Stack
+
+FastAPI, SQLAlchemy (SQLite), Pydantic, cryptography (Fernet)
+
+## Related
+
+- [kubera-web](https://github.com/oh-my-kubera/kubera-web) — Next.js dashboard (PWA)
+
+## License
+
+MIT

kubera_core-0.1.1/README.md

@@ -0,0 +1,45 @@
+# Kubera Core
+
+Personal asset management backend. All financial data stays on your machine.
+
+## Install & Run
+
+```bash
+pip install kubera-core
+kubera-core start
+```
+
+- API docs: http://localhost:8000/docs
+- Auth token is auto-generated and printed on first start
+
+## Options
+
+```bash
+kubera-core start --host 127.0.0.1 --port 3000
+kubera-core token                    # show current token
+kubera-core token --refresh          # generate new token
+```
+
+## Credential Management
+
+API keys for financial services are managed via CLI only (never through web).
+
+```bash
+kubera-core credential add upbit     # interactive masked input
+kubera-core credential list          # show status
+kubera-core credential remove upbit
+```
+
+Supported providers: upbit, kis, binance, codef
+
+## Tech Stack
+
+FastAPI, SQLAlchemy (SQLite), Pydantic, cryptography (Fernet)
+
+## Related
+
+- [kubera-web](https://github.com/oh-my-kubera/kubera-web) — Next.js dashboard (PWA)
+
+## License
+
+MIT

kubera_core-0.1.1/alembic/env.py

@@ -0,0 +1,44 @@
+"""Alembic environment configuration."""
+
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+from kubera.core.models import Base
+
+config = context.config
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

kubera_core-0.1.1/alembic.ini

@@ -0,0 +1,36 @@
+[alembic]
+script_location = alembic
+sqlalchemy.url = sqlite:///kubera.db
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

kubera_core-0.1.1/config/settings.yaml

@@ -0,0 +1,6 @@
+database_url: "sqlite:///kubera.db"
+host: "0.0.0.0"
+port: 8000
+debug: false
+cors_origins:
+  - "*"