Skip to main content

A comprehensive open-source toolkit for AI-powered analysis and interpretation of SEC EDGAR filings, providing valuable insights for investors, fintech developers, and researchers.

Project description

 

sec-ai

Essentials ➔       Documentation Status Licence Project Type: Federation Experimental
Health ➔              GitHub Workflow Status: ci.yml GitHub Workflow Status: cd.yml Last Commit
Quality ➔             codecov Code Style: Black Ruff
Distribution ➔    PyPI version PyPI - Python Version PyPI downloads
Community ➔     HitCount X (formerly Twitter) Follow GitHub stars

A comprehensive open-source toolkit for AI-powered analysis and interpretation of SEC EDGAR filings, providing valuable insights for investors, fintech developers, and researchers.


Overview

sec-ai is an open-source project designed to provide a comprehensive toolset for analyzing and interpreting data from SEC filings. Utilizing advanced AI technologies, this project aims to serve a wide range of users, from individual investors to researchers and regulatory bodies.

The project leverages alphanome-ai/sec-parser for its data extraction needs, an essential component that simplifies the parsing of SEC EDGAR HTML documents into a structured and analyzable format.

Installation

Open a terminal and run the following command to install sec-ai:

pip install sec-ai

Usage

import sec_ai as sa

# TODO: Examples are coming soon!

For more examples and advanced usage, you can continue learning how to use sec-ai by referring to the Quickstart User Guide.

Contributing

Contributing to sec-ai is a rewarding way to improve this open-source project. Whether you are a user interested in expanding your knowledge or a developer who wants to dive deeper into the codebase, we have comprehensive guides to get you started.

  • User Guide: If you are new to sec-ai and would like to get started, please refer to the Quickstart User Guide.

  • Developer Guide: For those interested in contributing to sec-ai, the Comprehensive Developer Guide provides an in-depth walkthrough of the codebase and offers examples to help you contribute effectively.

Both guides are interactive and allow you to engage with the code and concepts as you learn. You can run and modify all the code examples for yourself by cloning the repository and running the respective notebooks in a Jupyter environment.

Alternatively, you can run the notebooks directly in your browser using Google Colab.

Note Before contributing, we highly recommend familiarizing yourself with these guides. They will help you understand the structure and style of our codebase, enabling you to make effective contributions.

Best Practices

Importing modules

  1. Standard: import sec_ai as sa
  2. Package-Level: from sec_ai import SomeClass
  3. Submodule: from sec_ai import sub_module
  4. Submodule-Level: from sec_ai.sub_module import SomeClass

Note The root-level package sec_ai contains only the most common symbols. For more specialized functionalities, you should use submodule or submodule-level imports.

Warning To allow us to maintain backward compatibility with your code during internal structure refactoring for sec-ai, avoid deep or chained imports such as sec_ai.sub_module.internal_utils import SomeInternalClass.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sec_ai-0.5.1.post10.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sec_ai-0.5.1.post10-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file sec_ai-0.5.1.post10.tar.gz.

File metadata

  • Download URL: sec_ai-0.5.1.post10.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.11.5 Linux/6.2.0-1012-azure

File hashes

Hashes for sec_ai-0.5.1.post10.tar.gz
Algorithm Hash digest
SHA256 065da4e09654fea570c38c86c60ed6cce168b3f8231dfa7e98c7e8dec3fc7ec5
MD5 f3b742997f0ee8300fa2eacffe9d892f
BLAKE2b-256 e9664290326fae5a514403a081f159c91279a56c6216a45377d69d78ac4f3658

See more details on using hashes here.

File details

Details for the file sec_ai-0.5.1.post10-py3-none-any.whl.

File metadata

  • Download URL: sec_ai-0.5.1.post10-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.11.5 Linux/6.2.0-1012-azure

File hashes

Hashes for sec_ai-0.5.1.post10-py3-none-any.whl
Algorithm Hash digest
SHA256 e22f7de230e78f4f4f8cfb0e4f9bc198bba61b57cfb33b18856da21db04f76d2
MD5 c6f1a7ccfc6702d219b1058c39a1ad91
BLAKE2b-256 f9707cbfcbbf4ba9789785eaa4c8b3af30a624966d1fb578271b62814e0e7362

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page