diff --git a/openstack/__init__.py b/openstack/__init__.py
index e7db55965..06aa5236d 100644
--- a/openstack/__init__.py
+++ b/openstack/__init__.py
@@ -24,10 +24,13 @@ __all__ = [
 
 def connect(
         cloud=None,
-        app_name=None, app_version=None,
+        app_name=None,  # type: Optional[str]
+        app_version=None,  # type: Optional[str]
         options=None,
-        load_yaml_config=True, load_envvars=True,
+        load_yaml_config=True,  # type: bool
+        load_envvars=True,  # type: bool
         **kwargs):
+    # type: (...) -> openstack.connection.Connection
     """Create a :class:`~openstack.connection.Connection`
 
     :param string cloud:
diff --git a/openstack/py.typed b/openstack/py.typed
new file mode 100644
index 000000000..e69de29bb